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Quem sou eu? 


Meu nome é Lucas Souza, formado em engenharia da computação na Universide 
de Ribeirão Preto, trabalho profissionalmente com desenvolvimento de software há 
7 anos. Durante boa parte destes anos, trabalhei dentro de empresas situadas em 
Ribeirão Preto, há 4 anos estou em São Paulo. Nestes anos, trabalhei principalmente 
com Java e Ruby. 

Em 2005, já programava utilizando PHP, mas decidi que gostaria de aprender 
outras linguagens e optei por aprender Java. Rapidamente comecei à trabalhar com 
Java, no ano de 2006, partipei de um projeto onde foi possível aprender não só Java, 
mas também boas práticas de desenvolvimento de software: testes, integração con- 
tínua, refatoração de código, etc. 

No ano de 2008, tive a oportunidade de conhecer a Caelum. Foi quando re- 
solvi me mudar para São Paulo após receber o convite para trabalhar como consul- 
tor. Após alguns meses, tive a oportunidade me tornar instrutor dos cursos de Java 
existentes à epoca. Fui editor chefe do InfoQ Brasil por quase 2 anos, onde era res- 
ponsável pela manutenção, publicação e revisão de todo o conteúdo técnico do site. 
Também participei da criação dos novos cursos de Hibernate e JSF da Caelum, onde 
desenvolvi o gosto pela escrita. Paralelo a isso, tive contato com vários outros desen- 
volvedores da Caelum, que me incentivaram a aprender um pouco sobre Ruby, que 
já era uma vontade minha na época. 

Em 2011, recebi o convite para ser um dos integrantes do time responsável por de- 
senvolver o novo CMS do portal R7.com, que seria escrito principalmente em Ruby. 
Aceitei o desafio, e desde então me dedico diariamente no aprendizado de coisas 
novas em relação a linguagem Ruby. Mas não só isso, eu gosto particularmente, de 
resolver problemas relacionados a arquitetura que visam melhorar a escalabilidade 
e alta disponibilidade do portal. 

Procuro sempre as melhoras formas de escrever códigos legíveis e testáveis uti- 
lizando Ruby. Apesar de ser um apaixonado pela linguagem e considerá-la umas 
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das melhores com as quais já trabalhei, costumo criticar seus pontos fracos, inclu- 
sive no próprio livro. Acho que cada problema possui uma linguagem melhor para 
resolvê-lo. 


Um breve prefácio 


Ruby é uma linguagem dinâmica, orientada à objetos e que possui algumas carac- 
terísticas funcionais. Seu criador, Yukihiro Matsumoto queria uma linguagem que 
juntasse programação funcional e imperativa, mas acima de tudo que fosse uma lin- 
guagem legível. Esta é uma das grandes vantagens da linguagem, ser extremamente 
legível. 

Este livro é basicamente um tutorial e uma referência para a linguagem Ruby. 
Ele cobre a maioria das características da linguagem e também suas principais api's: 





String, Enumerable, File, etc. Além de questões mais avançadas que permiti- 
rao um maior aproveitamento da linguagem, como metaprogramação, distribuição 
de código e gerenciamento de dependências. 


Por quê Ruby? 


Além das características citadas acima, Ruby é a linguagem que eu utilizo para a 
maioria dos programas que escrevo, principalmente quando vou começar aplicações 
web. Trabalho há 2 anos com Ruby, e posso dizer que a linguagem é extramamente 
produtiva e simples, consigo fazer coisas simples, com poucas linhas de código. 


Nos últimos anos a linguagem progrediu assustadoramente. A comunidade cres- 
ceu bastante, possui o Rubygems, onde se encontram um grande número de projetos 
que auxiliam o dia a dia do desenvolvedor Ruby. No github, a grande maioria dos 
repositórios são escritos em Ruby, o que permite que a comunidade contribua cada 
vez mais para a melhoria do ambiente em volta da linguagem. 


Além disso, o framework MVC Ruby on Rails, permite a criação de aplicações 
web com extrema rapidez. Essa agilidade tem sido considerada por várias startups no 
momento da criação de seus produtos. A vantagem é que o número de vagas dispo- 
níveis no mercado crescem a cada dia, principalmente em polos de desenvolvimento 
como a Califórnia. 

Atualmente, aprender apenas Rails não é o suficiente. É necessário um bom co- 
nhecimento da linguagem para criar códigos que facilitem a manutenção e criação de 
novas funcionalidades. Aprendendo mais sobre a linguagem Ruby, faz com que você 
consiga escrever códigos mais legíveis e deixe de lado vícios que podem ter vindo de 
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outras linguagens que você trabalhava. 
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CAPÍTULO 1 


Uma introdução prática a linguagem 
Ruby 


Vamos começar com um pouco da história e características importantes da lingua- 
gem Ruby, para compará-la com com outras que você já deve ter trabalhado. Tam- 
bém mostraremos o porquê vários programadores têm falado e usado tanto esta lin- 
guagem, pela qual espero que você se apaixonara. 


1.1 QUANDO? ONDE? POR QUÊ? 


A linguagem Ruby foi criada por Yukihiro Matsumoto, mais conhecido como Matz, 
no ano de 1995 no Japão, com o objetivo de ser uma linguagem mais legível e agra- 
dável de se programar. 

Mas, além das características orientada a objetos, Ruby também foi criada para 
possuir um forte quê de linguagem funcional, tendo recursos poderosos e essenciais 
desse paradigma, como lambdas e closures. 
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Ela foi inspirada em outras linguagens como Perl, Smalltalk e Lisp, e hoje está 
entre as linguagens mais usadas, muito em função da disseminação do seu principal 
framework MVC, o Ruby on Rails - http://rubyonrails.org. 

Algumas características do Ruby devem ser fixadas desde o começo dos estudos, 
pois vão facilitar bastante nossa curva de aprendizado da linguagem, como a tipagem 
forte e dinâmica, além do fato da linguagem ser interpretada. Fique tranquilo caso 
você ainda não tenha escutado falar sobre esses alguns desses conceitos. 


1.2 INSTALAÇÃO 


Em 2013, o Ruby se prepara para receber a versão 2.0 da linguagem. Em fevereiro 
já saiu uma primeira versão, mas ainda pouco utilizada. Há um apêndice nesse li- 
vro para você fazer a instalação dessa versão mais recente, que traz recursos novos, 
também discutidos no fim do livro. 


Nessa seção vamos aprender a instalar o Ruby em cada sistema operacional: 


Mac OS 


Adivinhe? No Mac OS, o interpretador Ruby já está instalado! Abra o terminal 


e execute: 
ruby -v 


Na versão Mountain Lion, a versão pré-instalada é a 1.9.2 patch 290, conforme 


você pode ver na imagem a seguir: 
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lucas bash 80x24 





O Ruby possui varios interpretadores disponíveis, se você deseja utilizar versões 
mais novas que não estão disponíveis diretamente a partir do seu sistema operacio- 
nal, existem gerenciadores de versões do Ruby, por exemplo, o RVM (Ruby Version 
Manager). No apêndice “Gerenciadores de versões do Ruby” explicarei como elas 
funcionam e como instalá-las. 


Linux 


Se você for um usuário Linux, as distribuições em sua maioria, disponibilizam 
alguns interpretadores Ruby. Caso você esteja usando a versão 12.04 do Ubuntu, que 
é a mais recente, basta instalar o pacote do interpretador Ruby utilizando o apt-get 
install. Abra um terminal e execute o comando: 


sudo apt-get install ruby1.9.3 
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OS® Terminal 


lucas@lucas ~ 

$ sudo apt-get install ruby1.9.3 

Reading package lists... Done 

Building dependency tree 

Reading state information... Done 

The following package was automatically installed and is no longer required: 
authbind 

Use ‘apt-get autoremove' to remove then. 

The following NEW packages will be installed: 
ruby1.9.3 

O upgraded, 1 newly inshkalled, O to remove and 76 not upgraded. 

Need to get O B/13.0 kB of archives. 

After this operation, 190 kB of additional disk space will be used. 

Selecting previously unselected package ruby1.9.3. 

(Reading database ... 320632 files and directories currently installed.) 

Unpacking ruby1.9.3 (from .../ruby1.9.3 1.9.3.0-1ubuntu2.2 all.deb) 

Processing triggers for man-db ... 

Setting up ruby1.9.3 (1.9.3.0-1ubuntu2.2) 

lucasglucas 


$ 





Agora você pode conferir a versão instalada executando em um terminal: 
ruby -v 
E você verá na saída do terminal, algo como: 


OS® Terminal 


lucas@lucas ~ 

$ rubk -v 

ruby 1.9.3po (2011-10-30 revision 33570) [x86 64-linux] 
lucas@lucas ~ 

sã 
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Windows 


Caso o seu sistema operacional seja Windows, a maneira mais simples e fácil é 
utilizar umas das versões do RubyInstaller, que permite que você faça a instalação 
com apenas alguns cliques. 

O primeiro passo é baixar a última versão do RubyInstaller. Para isso, acesse o 
site: 


http://rubyinstaller.org/downloads/ 


9 Downloads 
— CD rubyinstaller.org/downloads/ xw = 
“e Ruby installer About Download Help Contribute 
or Windows 
Downloads T 
Rubylnstallers Archives» 


DOWNLOAD ISSUES? 
® Ruby 1.9.3-p194 


® Ruby 1.9.2-p200 
13 Ruby 1.8.7-p370 


Depending on your location, sometimes the downloads will not work. This 
is due RubyForge provided mirrors. Until we completely move our 
releases out of them. please add /noredirect at the end of the URL and 
try again. 


Other Useful Downloads 


Sorry the inconvenience. 


7-ZIP ARCHIVES SPEED AND COMPATIBILITY 


Ruby 1.9.3-p194 Rubyinstaller is compiled with MinGW 4.5.2 which offers improved speed 


dept and better RubyGem compatibility, including support for many more 
uoy Ad native C-based extensions such as Ruby FFI, Nokogiri, FXRuby and many 
(E) Ruby 1.8.7-p370 others 


Baixe a versão Ruby-1.9.3-p194, um arquivo executável que instalará auto- 
maticamente o interpretador Ruby em sua máquina. Quando o download terminar, 





execute o arquivo Ruby-1.9.3-p194.ex 


Clique em executar para prosseguir com a instalação. 
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F 
Abrir Arquivo - Aviso de Segurança 





Deseja executar este arquivo? 





a 1 Nome: ...ucumber-Windows\rubyinstaller-1.9.3-p194.exe 


omecedor: Luis Lavena 
Tipo: Aplicativo 
Origem: C:\Users\apinto\Desktop\Anderson\Programas\... 




















> Embora arquivos provenientes da Intemet possam ser úteis, este tipo 
© de arquivo pode danificar seu computador. Só execute software de 
editores em que você confia. Qual é o fisco? 














Em seguida, clique no botão I accept the License e em seguida no botão Avançar. 


E = m sy 
ESTE E 


Ruby 1.9.3-p194 License Agreement 





Please read the following License Agreement and accept the terms before continuing 


Ruby is copyrighted free software by Yukihiro Matsumoto. 
http://www. ruby4tang,org/en/LICENSE. txt 


The Book of Ruby is copyrighted by Huw Collingbourne. 
http: //www.sapphiresteel.com/The-Book-Of-Rub’ 











Agora marque as opções Add Ruby executables to your PATH para poder posteri- 
ormente executar o Ruby a partir de um terminal. Marque também a opção Associate 
.rb and .rbw file with this Ruby installation para que os arquivos . rb sejam interpre- 
tados como arquivos que contém código Ruby. Por fim clique na opção install. 
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Setup will install Ruby 1.9.3-p194into the following folder. Click Install to 
continue or dick Browse to use a different one. 


Please avoid any folder name that contains spaces (e.g. Program Files). 
C:\Ruby193 Browse... 


to your PATH 
[7] Associate .rb and .rbw files with this Ruby installation 





TIP: Mouse over the above options for more detailed information. 


Required free disk space: ~51,1MB 











Please wait while Setup installs Ruby 1.9.3-p194 on your computer. 





C:\Ruby 193\ib\yuby\1.9. 1\yesolv.rb 
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A instalação será completada com sucesso. Para finalizar basta clicar no botão 
«Finish. 





= 
j5! setup - Ruby 1.9.3-p194 









Completing the Ruby 
1.9.3-p194 Setup Wizard 






Setup has finished installing Ruby 1.9.3-p194 on your 
computer, The application may be launched by selecting the 
installed icons. 






Click Finish to exit Setup. 







Web Site: http: //rubyinstaller.org 
Support group: http://groups.google.com/group/rubyinstaller 
Wiki: http://wiki.github.com/onedick/rubyinstaller 







How about a toolkit for building native C RubyGems? 
Devkit: http: //rubyinstaller .org/add-ons/devkit 



















Para testar que a instalação foi feita com sucesso, abra um terminal e execute o 
comando ruby -v e veja que o Ruby foi instalado: 





q SEE) 


R -u z | 
ruby 1.9.3p194 (2012-04-20) [1386-mingu32] 





i 
GE Administrador: C\WINDOWS\system32\cmd.exe - irb 





C:\>irb 
irblmain):001:0> m 
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1.3 TUDO PRONTO... MÃOS À MASSA: INFERÊNCIA DE TIPOS 


Um dos conceitos básicos em linguagens de programação é a declaração de variáveis, 
que é apenas uma associação entre um nome e um valor. Em Ruby, basta definirmos 
o nome da variável e atribuir um valor usando o sinal =: 


idade = 27 


O código acima, deve ser executado dentro do IRB (Interactive Ruby Shell), um 
pequeno shell que permite que códigos Ruby sejam criados e testados. Como os 
códigos dos primeiros capítulos são simples, vamos testá-los dentro do IRB. Para 
executá-lo, basta digitar irb no terminal de sua preferência ou no console do Win- 
dows. 

Outra forma de criar e executar código Ruby é criando um arquivo .rb e 
executá-lo utilizando o comando ruby. Se o código acima fosse digitado dentro 
de um arquivo idade.rb para executá-lo faríamos: 


ruby teste.rb 


Durante os primeiros capítulos do livro, utilizaremos o IRB, conforme os códigos 
ficarem complexos, é preferível que eles sejam criados dentro de arquivos %.rb 

Ao executarmos o código, estamos definindo uma variável chamada idade e 
atribuindo o valor 27. Mas qual tipo desta variável? Não é necessário declararmos 
se ali será guardado um número, um texto ou um valor booleano? 

A variável que criamos é do tipo Fixnum, um tipo especial do Ruby que repre- 
senta número inteiros. Mas não declaramos essa informação na variável idade. 
Sendo assim, como Ruby sabe que o tipo da variável é numérico? 

Ao contrário de outras linguagens, como C, onde é necessário declararmos o tipo 
da variável, na linguagem Ruby isso não é necessário, pois o interpretador infere o 
tipo da variável automaticamente durante a execução do código. Esta característica 
é conhecida como inferência de tipos. 





TESTE SEUS CÓDIGOS ONLINE 


Se você estiver com um pouco mais de pressa e quiser testar os códigos 
de exemplo logo, você pode usar o site http://tryruby.org. Ele funciona 
como um IRB, porém, dentro do seu browser favorito. Extremamente 
útil para quando você quer fazer um teste rápido, mas está em um com- 
putador que não tenha o Ruby instalado. 
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Para verificar de que tipo é a variável idade, basta executar o código abaixo: 


idade = 27 
puts idade.class 


Quando invocamos . class em qualquer variável, o interpretador Ruby retorna 
o tipo da variável, que será impressa no IRB pelo método puts. Neste caso, o tipo 
retornado é Fixnum. 


1.4 TIPAGEM FORTE E DINÂMICA 


Se eu não declaro qual o tipo da minha variável, quer dizer que o tipo dela não im- 
porta para meu interpretador? 

Para a linguagem Ruby, a resposta é não. E esta definição é uma das que causa 
mais confusão na cabeça das pessoas que estão começando a programar em Ruby. 
Por ser uma linguagem com inferência de tipos, muitos pensam que o tipo não im- 
porta para o interpretador como acontece com o PHP. Confuso? Vamos ver isso na 
prática. 

Se criarmos duas variável em um código PHP qualquer, sendo uma contendo 
uma String, como valor 27 e outro de tipo numérico com valor 2: 


<?php 
$idade = 27; 
$multiplicador = "2"; 


$idade * $multiplicador; 
?> 


Ao executarmos o código acima, o resultado será 54. Para o interpretador do 
PHP, quando executamos uma operação matemática envolvendo uma variável do 
tipo int e uma do tipo String, os valores das variáveis podem ser automatica- 
mente convertidos para outros tipos, a fim de possibilitar a operação. 


Se executarmos exatamente o mesmo código em Ruby: 


idade = 27 
multiplicador = "2" 


idade * multiplicador 
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Casa do Código Capítulo 1. Uma introdução prática à linguagem Ruby 








Opa! Não funcionou. O interpretador retornou TypeError: String can't 
be coerced into Fixnum. O Ruby não permite que uma variável Fixnum seja 
somada com outra do tipo String, diferentemente do que ocorre no PHP, que 
permite este tipo de operação. Isso acontece porque para o interpretador Ruby é 
impossível multiplicar um número com um texto. 

Essa característica da linguagem de realizar operações em variáveis de tipos di- 
ferentes é o que chamamos de tipagem fraca ou forte. No caso do Ruby, onde o tipo 
é determinante para o sucesso da operação, dizemos que a linguagem tem tipagem 
forte. 


Tendo a tipagem forte em mente, vamos ir mais além. Execute o seguinte código: 


idade = 27 
idade = "27" 
Funcionou? 


Este código funciona normalmente, porque não estamos fazendo nenhuma ope- 
ração que misture os tipos. O código acima apenas atribui um Fixnum à variável 
idade e depois atribui um outro valor, só que do tipo String. Quando a linguagem 
permite que o tipo da variável possa ser alterado durante a execução do programa, 
dizemos que ela tem tipagem dinâmica. 

Em contrapartida, outras linguagens possuem tipagem estática, ou seja, uma vez 
que a variável é criada como um int, ela só poderá ser um int. Esse é o caso do 
Java, onde o compilador cuida de fazer essa checagem. 

Esta é uma das características mais criticadas pelos desenvolvedores que prefe- 
rem linguagens com tipagem estática, uma das alegações é que em linguagem com 
tipagem estáticas podemos descobrir erros durante a compilação. Porém, veremos 
durante o livro que a tipagem dinâmica é uma das características mais poderosas da 
linguagem, trazendo tamb;em muitos benefícios. 

Vale lembrar que os conceitos forte, fraca, dinâmica e estática não são tão simples 
assim. É mais fácil falar se uma linguagem é mais ou então menos fortemente tipada 
que outra, por exemplo. Nesse capítulo apenas tocamos de leve nesse assunto. 


1.5 UMA LINGUAGEM INTERPRETADA E COM CLASSES ABER- 
TAS 


Ruby é uma linguagem interpretada, ou seja, não existe um processo de compilação 
para um binário executável, como acontece na linguagem C, por exemplo. Em Ruby, 
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existe um arquivo com a extensão .rb e um programa cujo papel é interpretar o 
conteúdo deste arquivo, transformando-o em instruções de máquina e executando 
o comportamento esperado. 

Vamos para um exemplo prático que precisamos resolver: descobrir o plural de 
todas as palavras, por exemplo. 

Um caminho natural para solucionar este problema, é criar um método que re- 
cebe uma String como entrada e adicione um s após a sua última letra (sim, estou 
pensando apenas nos casos mais simples). 


Vamos ao código que soluciona este problema: 


def plural(palavra) 
"#{palavra}s" 
end 


puts plural("caneta") # canetas 
puts plural("carro") # carros 














Não se preocupe ainda com o significado do # dentro da String no método 
plural, vamos falar bastante dela durante o livro. O puts é um método simples 
que pega o argumento passado e joga para a saída padrão. Dentro do IRB, bastaria 
escrever plural ("caneta") que automaticamente o interpretador joga o resul- 
tado no console. Faça o teste! 

Olhando este código com cuidado, ele não nos parecerá tão orientado a objetos 
assim. Repare que os dados e os comportamentos estão separados, mas podemos 
tentar melhorar isso. Já que o método plural age somente na própria String, 
nada mais natural que ele esteja na classe String, assim usaríamos: 


uts "caneta".plural 
P P 
puts "carro" .plural 


Porém, ao executarmos o código acima receberemos o seguinte erro como re- 
torno: 


NoMethodError: undefined method `plural' for "caneta" :String 


Isso significa que objetos do tipo String não possuem o comportamento 
plural. Mas espera aí... e se escrevêssemos o método plural dentro da classe 
String? 
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class String 
def plural 
"#{self}s" 
end 
end 


Agora tente executar o código que coloca a String “caneta” no plural: 


puts "caneta".plural # canetas 


Agora funciona! O que fizemos foi “abrir” a classe String durante a execução 
do código e adicionamos um novo método que estará disponível para todos os ob- 
jetos do tipo String que existem. Esse recurso é conhecido como classes abertas 
(OpenClasses), recurso que veremos bastante ainda durante os próximos capítulos e 
discutiremos bastante suas vantagens e desvantagens. 

Por enquanto, é importante termos em mente alguns problemas em relação a 
linguagens interpretadas. Um desses problemas é não conseguirmos descobrir erros 
do programador durante a codificação do programa, mas apenas quando tentamos 
executá-lo, já que não temos um compilador que consegue checar por erros para 
nós. Para contornar esse problema, os desenvolvedores Ruby, desde cedo, mantém o 
hábito de desenvolver testes de unidade para suas classes, a fim de tentar descobrir 


possíveis erros existentes no programa o mais rápido possível. 


1.6 ONDE EU USARIA RUBY? 


É muito comum encontrar a linguagem Ruby sendo usada para a criação de scripts 
para ler e processar arquivos, automatizar builds e deploys, fazer crawling de sites 
etc. 

Mas sem dúvidas os maiores cases de sucesso da linguagem Ruby estão liga- 
dos a aplicações web. A criação do Rails sem dúvidas foi o que mais alavancou o 
sucesso da linguagem. Ele é um framework web que segue o padrão MVC (Model- 
View-Controller) e evangeliza o Convention over configuration, ou seja, acabar com 
aquela quantidade enorme de XMLs que existem na maioria dos frameworks web 
que existem no mercado e que dificultam muito a manutenção. 

Surgiu dentro da empresa 37signals e foi criado por David Heinemeier Hansson, 
que resolveu extrair parte da lógica web de um projeto chamado Basecamp. Exis- 
tem vários cases de sucesso na web como o próprio Basecamp, A List Apart (revista 
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com dicas de desenvolvimento de aplicações web), Groupon (Maior site de vendas 
coletivas de mundo), etc. 

Existem também vários SaaS (Softwares as a Service) disponíveis que foram cri- 
ados em Rails e que permitem a criação de aplicações em minutos. O Shopify é um 
deles e permite a criação de sua própria loja virtual, com template personalizado, 
lista de produtos, pagamento em cartão de crédito, isso tudo com apenas alguns cli- 
ques. Além de vislumbrar o uso na criação da sua própria loja, você pode pensar em 
criar o seu próprio SaaS usando Rails com bastante rapidez. 

Foi o que o pessoal da MailChimp fez. Eles criaram um serviço que ajuda você a 
criar o design do seu e-mail de newsletters, compartilhá-lo em redes sociais e integrar 
com outros serviços que você já utiliza. Tudo isso com poucos cliques. 

O importante é que o mercado em torno da linguagem Ruby é muito grande 
atualmente, e a tendência é que continue crescendo nos próximos anos. São várias 
as vagas existentes para trabalhar com Ruby e/ou Rails atualmente. Vários serviços 
estão sendo criados e uma grande quantidade de Startups apostam na linguagem e 
nas suas aplicações. 

Tenha em mente que o quanto mais você dominar a linguagem Ruby, mais fácil 
será para você conhecer profundamente os frameworks como o Rails e as diversas 
bibliotecas relacionadas. 


Vamos começar nossa jornada? 
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CAPÍTULO 2 


Seu primeiro passo no Ruby: 
convenções e as diferentes estruturas 
primitivas 


Acabamos de aprender um pouco sobre o Ruby, escrevemos já algum código, o sufi- 
ciente para que pudéssemos fazer um “olá mundo” e entender alguns dos conceitos 
por trás da linguagem. 

Antes de criar uma aplicação, que começará a ser escrita no próximo capítulo, 
precisamos nos acostumar com algumas sutilezas da linguagem e também com as es- 
truturas básicas. Vamos aprender mais sobre os tipos existentes na linguagem, como 
representar ausência de valores, as diferentes maneiras de escrever as estruturas con- 
dicionais e também os loops. 

Uma boa dica é continuar testando os nossos códigos no IRB, e também experi- 
mentando suas curiosidades para obter diferentes resultados. 


2.1. Mais tipos no Ruby Casa do Código 





2.1 MAIS TIPOS NO RUBY 


Como vimos no capítulo anterior, a declaração de variáveis em Ruby é um processo 
bastante simples, bastando escolher o nome da sua variável e atribuir um valor para 
ela. Esteja atento, pois deve ser respeitada a regra de começá-las com letras, $ ou _. 


1 = "Lucas" # não funciona 
nome = "Lucas" & funciona 

$nome = "Lucas" # funciona 
_nome = "Lucas" & funciona 


Mas e quando nossa variável possui nomes compostos? Em algumas lingua- 
gens é convencionado que cada palavra que formará o identificador da variável co- 
mece com letra maiúscula, exceto a primeira, por exemplo, telefoneCelular, 
ou então numeroDeRegistro. Essa convenção é conhecida como Camel Case. 
Em Ruby, utilizamos outra convenção para separar as palavras. Nela, usamos sem- 
pre letras minúsculas e como separador o _, dessa forma poderíamos ter a variável 


telefone celular. 


telefone celular = "(11) 91234-5678" 


2.2 COMENTE SEU CÓDIGO 


Se você estava atento, deve ter reparado que algumas vezes utilizamos uma # no 
código que mostrava os diferentes exemplos de declaração de variável em Ruby. Es- 
távamos na verdade fazendo um comentário. Esse é o conhecido comentário de 1 
linha. Assim, se existirem N linhas e você deseje comentar todas elas, terá que adi- 
cionar # linha por linha. 


#idade = 27 
#ano = 2013 


Para esses casos onde precisamos comentar diversas linhas, podemos utilizar os 
comentários em bloco, que podem ser feitos usando envolvendo o conteúdo a ser 
comentado entre as demarcações =begine =end. 


=begin 
idade = 27 
ano = 2013 
=end 
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Com isso, esses códigos serão desconsiderados na interpretação do seu pro- 
grama. 


2.3 O TRABALHO COM NÚMEROS 


Em qualquer aplicação que é desenvolvida, em algum momento deve-se trabalhar 
com números. Muitas das informações podem ser representadas com um número 
inteiro, como idade, ano ou quantidade estoque, por exemplo. Nesse caso, 
declaramos a variável com o número: 


idade = 27 
ano = 2013 


Ao trabalharmos com números inteiros, podemos descobrir seu tipo pergun- 
tando para a variável qual é a sua classe: 


idade.class 
=> Fixnum 


Repare que => Fixnum não precisa ser digitado, ele apenas indica qual será a 
saída do IRB. Ao longo do livro, utilizarei esta abordagem para indicar qual o retorno 
de uma chamada dentro do IRB, facilitando sua leitura. 

Números inteiros geralmente são do tipo Fixnum, exceto em casos extrema- 
mente grandes onde o Bignum é empregado. No entanto, números muito grandes 
e que precisamos representar de forma literal podem ficar complicados de ler no 
código. Por exemplo, a quantidade de habitantes no mundo em 2013, poderíamos 
fazer: 


habitantes = 7000000000 


7 bilhões de habitantes é um número consideravelmente grande. Mas e se fosse 
70 bilhões? 


habitantes = 70000000000 


Repare que não é tão fácil perceber que há um zero a mais nesse grande número. 
Para esses casos, Ruby nos permite separar os milhares através do % . 


habitantes = 7.000 000 000 
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Com isso conseguimos deixar o número literal mais legível. 
Em outras situações, podemos precisar definir números que tenham casas deci- 
mais. Por exemplo, para representar o peso de uma pessoa: 


peso = 77.9 


Repare que a separação das casas decimais é o . (ponto) enãoa , (vírgula). 


2.4 REPRESENTAÇÃO DE TEXTOS COM AS STRINGS 


Muitas das vezes precisamos de variáveis que guardem informações que são compos- 
tas por texto, como o nome de uma pessoa e seu identificar em alguma rede social. 
Esse tipo de informação é o que chamamos de string. Em Ruby, qualquer carac- 
tere ou conjunto de caracteres cercado de aspas simples ou duplas é considerado uma 


String: 
nome completo = "Lucas Souza" 
twitter = '@Lucasas' 


puts nome completo.class # => String 
puts twitter.class # => String 


Mas por qual motivo e quando eu uso String com aspas simples ou duplas? 
Imagine que você possui uma amiga chamada Joana d'Arc e precisamos armaze- 


nar o nome dela em uma variável: 


nome com aspas simples = 'Joana d'Arc' # não funciona 
nome com aspas duplas = "Joana d'Arc" # funciona 


Repare que quando definimos String com aspas simples, não conseguimos 
adicionar outra aspas simples dentro do texto, pois dessa forma é o interpretador 
não sabe onde fica o final da String. Neste caso o único jeito é usar aspas duplas. 

Mas existem outros casos onde Strings com aspas duplas são mais interessantes. 
Precisamos agora exibir uma mensagem de boas-vindas contendo o nome da pessoa 
que está definido dentro da variável nome. O mais natural seria repetir o compor- 
tamento de outras linguagens e usar o operador + para realizar uma concatenação. 


nome = "Joana d'Arc" 


boas vindas = "Seja bem-vinda(o) " + nome 


puts boas vindas & => Seja bem-vinda(o) Joana d'Arc 
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Porém em Ruby quando precisamos concatenar duas String, preferimos fazer 
o uso da interpolação: 


nome = "Joana d'Arc" 
boas vindas = "Seja bem-vinda(o) #{nome}" 
puts boas vindas & => Seja bem-vinda(o) Joana d'Arc 


Basta colocar dentro da String a variável dentro de #{variavel}. É uma 
maneira mais elegante e comum de ser usada em códigos Ruby. O detalhe é que em 
String definidas com aspas simples não é possível fazer uso da interpolação. 

Prefira sempre o uso de String com aspas duplas e priorize sempre a interpo- 
lação quando for concatenar. 


Existe diferença de performance entre String com aspas simples e duplas? 


Existe muita discussão sobre qual tipo de declaração de string devemos uti- 
lizar, com o argumento que a declaração com aspas simples são mais rápidas que as 
declarações com aspas duplas. 

As String declaradas com aspas simples podem ser sutilmente mais rápidas 
que as declaradas com aspas duplas porque o analisador léxico da linguagem Ruby 














não tem que checar se existem marcadores de interpolação #{}. Este número pode 
variar de interpretador para interpretador e vale ressaltar que este tempo seria menos 
durante o parser do código e não durante a execução do mesmo. 

A diferença é tão insignificante que não vale a pena perdermos tempo com esse 
tipo de comparação. Eu particularmente prefiro declará-las sempre com aspas du- 
plas, porque se em determinado momento eu precisar interpolar o valor de alguma 
variável dentro desta String, ela já foi criada de uma maneira que não preciso 
alterá-la. 

A única preocupação que devemos ter é com o que vamos interpolar dentro de 
uma String. Por exemplo: 


puts 'mensagem' # => mensagem 
puts "#{sleep 1Jmensagem" & => mensagem 


A String declarada com aspas duplas interpola a chamada de um método da 
classe Kernel que interrompe a execução do código por 1 segundo, ou seja, o tempo 
para impressão da segunda String mensagem será de pelo menos 1 segundo. 
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2.5 ESTRUTURAS DE CONTROLE 


Ruby possui as principais estruturas de controle ( if, while etc) assim como as 
linguagens Java, C e Perl. Porém ao contrário destas que usam chaves {e ) para 
definir o conteúdo da estrutura, em Ruby usa-se as palavra reservada end apenas 
para finalizar o corpo da estrutura. 

Supondo que desejamos imprimir conteúdo da variável nome apenas sea idade 
for maior que 18, usamos a estrutura if, que em Ruby possui a seguinte sintaxe: 


idade = 27 
nome = "Lucas" 


if(idade > 18) 
puts nome # => Lucas 
end 


Uma maneira de deixar o código Ruby ainda mais simples é removendo os pa- 
rênteses da chamada do if. 


idade = 27 
nome = "Lucas" 


if idade > 18 
puts nome # => Lucas 
end 


Uma das vantagens do Ruby, é que na maioria das vezes podemos omitir o uso 
dos parenteses. Isso é o que chamamos de Syntax Sugar ou “açúcar sintático” da 
linguagem, que visa deixar o código mais legível. 

Falando em deixar o código mais legível, se o corpo do seu %if possuir apenas 
uma linha, prefira uma sintaxe mais enxuta: 


idade = 27 
nome = "Lucas" 


puts nome if idade > 18 # => Lucas 


Repare que parece que estamos lendo um texto em inglés: “Imprima nome se 
a idade for maior que 18”. Esta é uma das grandes vantagens da linguagem, maior 
legibilidade sempre que possivel. 
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2.6 ENTENDA O VALOR NULO 


Quando desejamos representar algum valor vazio em Ruby, usamos a palavra reser- 
vada nil. O nil não representa uma String vazia ou o número zero, ele re- 
presenta um valor vazio, um espaço vazio. Quando atribuímos nil a uma variável, 


queremos dizer que ela não possui nenhum valor. 
caixa = nil 


A nossa variável caixa, não possui nada dentro dela, ou seja, é vazia. 
Neste contexto, podemos imprimir uma mensagem de boas vindas caso o con- 
teúdo da variável nome tenha algum valor não nulo usando o método nil?: 


nome = "Lucas" 
puts "Seja bem-vindo #{nome}" if not nome.nil? # => Seja bem-vindo Lucas 


Se executarmos o código acima, a mensagem ‘Seja bem-vindo Lucas’ será exi- 
bida. Mas e no caso da variável possuir o valor nil: 


nome = nil 
puts "Seja bem-vindo #{nome}" if not nome.nil? 


Neste caso nenhuma mensagem será exibida, a variável nome é nula e o método 
nil? retorna true. Como fazemos a negação usando o not o valor é invertido e 
portanto false. 


Um pouco complicado, não é? Você vai se acostumar rapidamente. 


2.7 SUBSTITUA O “IF NOT” POR “UNLESS” 


Podemos simplificar o código acima usando a condicional negada, o unless (“a 
menos que” no bom português). 


nome = nil 
puts "Seja bem-vindo #{nome}" unless nome.nil? 


Podemos ler o código: “Imprima “Seja bem vindo ..’ a menos que o nome seja 
nulo” Na maioria das vezes que implementamos um if not, ele pode ser conver- 
tido para um unless. 

E se eu disser que podemos melhorar ainda mais o nosso código. Interessante, 
não? Pois é, existe algo que você ainda não sabe sobre as variáveis com valor nil. 

Se usadas dentro de condicionais como if e unless a variável quando nil 
assume automaticamente o valor true e no caso contrário, assume o valor false. 
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nome = nil 
puts "Seja bem vindo #{nome}" if nome 


A variável nome possui o valor nil e assume o valor false na condicional 
anterior, sendo assim nenhuma mensagem é impressa no terminal. Se a variável 
possuir algum valor não nil: 


nome = "Lucas" 
puts "Seja bem-vindo #{nome}" if nome # => Seja bem-vindo Lucas 


A mensagem Seja bem-vindo Lucas é impressa, pois a variável não é nil e por- 
tanto assume o valor true. 


2.8 ITERACOES SIMPLES COM FOR, WHILE, UNTIL 


For 


Existem diversas formas de iterar um determinado número de vezes por um código 
Ruby. Como em outras linguagens, existem os conhecidos while, untile for. 
Sem dúvida, a maneira mais usada em códigos Ruby que você irá se deparar ao longo 
do tempo é o for. 

Desejamos imprimir os números de 1 até 100. Apenas adicionando uma mensa- 
gem “Numero: X’ para deixarmos nossas mensagens mais elegantes. 


for numero in (1..100) 
puts "Numero: #{numero}" 
end 


O código acima atribui à variável numero os valores de 1 até 100, executa a 
conteúdo do for que termina quando usamos a palavra reservada end. O detalhe 
mais importante do código acima, é (1..100), que cria um range de número de 1 
até 100, que é exatamente o número de vezes que desejamos executar a impressão de 
um número. 


While 


Podemos utilizar iterar de 1 até 100 imprimindo cada um dos números utilizando 
a estrutura de repetição while, que assim como em linguagens tradicionais como 
Java e C, executando um bloco de código até que uma determinada condição seja 
falsa (conteúdo que também é delimitado pela palavra reservada end). 
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numero = 0 

while numero <= 100 
puts "Numero: #{numero}" 
numero += 1 

end 


Quando for executado o código acima executará a impressão da mensagem “Nu- 
mero: x’ imprimindo de 1 até 100, quando a condição do while será false. 


Until 


Ao contrário do while que termina sua execução quando uma condição falsa 
seja alcançada, a estrutura de repetição until executa um determinado bloco de 
código até que uma condição verdadeira seja encontrada: 


numero = 0 

until numero == 100 
puts "Numero: #{numero}" 
numero += 1 

end 


A diferença é que o código acima executará a impressão da mensagem “Numero: 
x de 1 até 100, até que o valor da variável numero seja 100 e ocorra o término na 
execução do until. 


2.9 AS OUTRAS FORMAS DE DECLARAR STRINGS 
Aprendemos e discutimos duas formas de declarar String: 


aspas simples = 'linguagem ruby' 
aspas duplas = "linguagem ruby" 


Mas como proceder caso precisemos declarar String com aspas duplas e aspas 
simples dentro, por exemplo: "Isso é “normal” e ‘util’ no mundo Ruby”. Nenhuma das 
duas abordagens anterior resolvem o problema sem o uso do caractere de escape \. 


string especial usando aspas simples = 

‘Isso é "normal" e \'util\' no mundo Ruby' 
string especial usando aspas duplas = 

"Isso é \"normal\" e 'util' no mundo Ruby" 
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puts string especial usando aspas simples 
# => 'Isso é "normal" e \'util\' em Ruby' 


puts string especial usando aspas duplas 
# => "Isso é \"normal\" e 'util' em Ruby" 


Existe uma notação na linguagem Ruby que foi inspirada no Perl que permite 
declararmos este tipo de String especial. Basta declará-la da seguinte forma: 


string especial = %{Isso é "normal" e ‘util' no mundo Ruby} 
puts string especial 
# => "Isso é \"normal\" e 'util' em Ruby" 


Na verdade qualquer caractere não alfa numérico pode ser usado após o >% , 
por exemplo: 


string especial = %[Isso é "normal" e 'util' no mundo Ruby] 
puts string especial 
# => "Isso é \"normal\" e 'util' em Ruby" 


string especial = 4?Isso é "normal" e ‘util' no mundo Ruby? 
puts string especial 
# => "Isso é \"normal\" e 'util' em Ruby" 


string especial = 4 Isso é "normal" e ‘util' no mundo Ruby” 
puts string especial 
# => "Isso é \"normal\" e 'util' em Ruby" 


Obviamente o caractere utilizado para delimitar a String deve ser escapado 
com “\” caso apareça dentro do texto que está sendo declarado: 


string especial = %{Isso é "normal" e \{util no mundo Ruby} 
puts string especial 
# => "Isso é \"normal\" e {util em Ruby" 


Entretanto se você utilizar como delimitador os caracteres (parenteses), 
[colchetes], (chaves) ou <menor e maior> eles podem aparecer dentro 
da String sem serem escapados caso sejam usados em pares (diferentemente do 
exemplo dado anteriormente): 


string especial = %{Isso é "normal" e {util} no mundo Ruby} 
puts string especial 


# "Isso é \"normal\" e {util} em Ruby" 
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Esta forma de declaração de St ring possui algumas variações, que podem, por 
exemplo, adicionar a capacidade de interpolar variáveis. 


* %q : Não permite interpolação; 


e %Q : Permite interpolação. 


Existem algumas outras variações que vamos aprender ao longo do livro. Esta 
maneira de declarar String permite que sejam elas também criadas com múltiplas 
linhas: 


string especial = (Isso é "normal" e {util} no mundo Ruby 
e a partir de agora veremos a 'todo' momento} 
puts string especial 


Repare que uma quebra de linha (In) é inserida exatamente no lugar onde que- 
bramos a linha em nosso código. Essa característica é muito útil quando precisamos 
criar String grandes e precisamos deixá-las mais legíveis. 


2.10 PRÓXIMOS PASSOS 


Neste capítulo aprendemos boas convenções de código nas declarações de variáveis, 
alguns outros tipos de dados existentes na linguagem Ruby, estruturas de controle 
como ife unless e as melhores formas de utilizá-las, a fim de diminuir ruídos na 
sintaxe e as conhecidas e úteis estruturas de repetição for, while e until. 

Aprendemos também as diferentes formas de declararmos String, com varia- 
ções e suporte a múltiplas linhas. O interessante valor nil que será muito utilizado 
durante todo o restante do livro. 

O importante é lembrar que estes conceitos são a base que precisamos para seguir 
em frente e aprendermos recursos mais avançados da linguagem. 

Portanto, não deixe dúvidas para trás, se preciso, volte e leia novamente partes 
que você julga necessário antes de prosseguirmos. 
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O começo da nossa aplicação 


Nos capítulos anteriores, aprendemos algumas funcionalidades básicas da lingua- 
gem Ruby. E, como já vimos, uma das suas principais características é ser orientada 
a objetos. Neste capítulo focaremos na criação de classes, métodos e objetos usando 
todo o poder que a linguagem nos proporciona. 

Começaremos construindo uma aplicação que servirá de base para os próximos 
capítulos do livro. Portanto, é interessante que você faça os códigos e entenda os 
conceitos explicados neste capítulo. 

Existem vários assuntos que poderíamos abordar e neste livro construiremos 
uma aplicação para controlar uma loja de livros. Controlaremos o seu estoque, quais 
são os clientes da loja, faremos algumas vendas e guardaremos todas estas informa- 
ções em disco, utilizando a API de arquivos do Ruby. 

A grande pergunta que sempre fica quando criamos uma aplicação é: por onde 
começar? Temos muitas opções. Podemos iniciar o desenvolvimento pelo domínio 
(criando classes), pela interface do usuário, pelo banco de dados e assim por diante. 
No nosso caso, começaremos desenvolvendo as classes de domínio da aplicação. 


3.1. A definição da classe Livro Casa do Código 





3.1 A DEFINIÇÃO DA CLASSE LIVRO 


Se vamos construir uma aplicação que gerencia uma loja de livros, precisamos man- 
ter os dados dos nossos livros em algum lugar. Pensando brevemente neles, teremos: 


nome = "Linguagem Ruby" 
"123-45678901-2" 
numero paginas = 245 


isbn 
preco = 69.90 

Todos os livros da nossa loja estão com um desconto pré-definido: 
desconto = 0.1 


Agora precisamos saber qual é o preço do nosso livro com desconto. Uma conta 
bem simples pode nos devolver qual o valor com o desconto: 


nome = "Linguagem Ruby" 
"342-65675756-1" 
numero paginas = 245 


isbn 


preco = 69.90 
desconto = 0.1 


preco com desconto = preco - (preco * desconto) 


O problema deste código, todo espalhado, é que, quando precisarmos calcular 
o desconto de qualquer livro, teremos que repetir a mesma operação. Se em algum 
momento esta lógica tiver que ser alterada, vamos ter que mudar em N lugares do 
nosso código. 

Podemos voltar um pouco no tempo e imitar as antigas e clássicas funções que 


temos em linguagens como C. 


def preco com desconto(preco, desconto) 
preco - (preco * desconto) 
end 


Agora, toda vez que precisarmos efetuar o cálculo do preço com desconto, cha- 
mamos a função preco com desconto passando o precoeo desconto 


nome = "Linguagem Ruby" 
"342-65675756-1" 


isbn 
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numero paginas = 245 


preco = 69.90 
desconto = 0.1 


puts preco com desconto(preco, desconto) # => 62.90 


Caso haja necessidade de alterar algum outro livro, devemos criar as va- 
riáveis referentes as informações deste outro livro e então chamar o método 


preco com desconto para sabermos qual o novo valor: 


nome = "Test Driven Development: Teste e Design no Mundo Real" 
isbn = "342-65675751-1" 
numero paginas = 212 


preco = 89.90 
desconto = 0.1 


puts preco com desconto(preco, desconto) # => 80.90 


O que temos aqui é um típico caso onde os dados e a sua manipulação estão 
separados, quando deveriam estar juntos. Esse é um dos princípios por trás da Ori- 
entação à Objetos, unir dados e a manipulação dos mesmos, encapsulando o acesso. 
A maneira de fazermos isso é colocando este código dentro de uma classe e repre- 
sentar cada um dos livros da nossa loja como uma instância desta classe. 

Para criar classes usando Ruby, basta usar a palavra reservada class e delimitar 
o final da sua classe com a palavra reservada end. 


class Livro 
end 
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CONSTANTES 


O nome de uma classe deve obrigatoriamente começar com uma letra 
maiúscula e as outras minúsculas. Por exemplo: Livro. Repare que o 
nome Livro não é uma String, já que não está entre aspas ou den- 
tro do delimitador de string. O nome Livro é uma constante, que 
definimos quando criamos a nossa classe. 

Todos os tipos existentes no Ruby como String, Integer, Time 
etc, são constantes. 

Caso o nome da sua constante seja composto, usamos a notação camel 





case, por exemplo: UnidadeDeEstoque 











O que criamos foi uma abstração de um Livro ou seja, um template que dirá do 
que um livro é composto. A partir da classe, que é o template, precisamos criar um 
novo livro, onde poderemos dizer quais são suas características, como título, isbn, 
autor e assim por diante. Para criarmos cada um, usaremos a palavra new: 


teste e design = Livro.new 
web design responsivo = Livro.new 


Quando usamos o new em uma classe, estamos criando uma instância dela (di- 
zemos também que estamos criando um objeto daquele tipo). No código anterior, 
criamos duas instâncias e as referenciamos através das variáveis teste e design 
e web design responsivo. Nós não provemos nenhum tipo de informação so- 
bre estes livros, como o nome do autor, isbn, quantidade de páginas etc. Esse é um 
dos princípios da orientação a objetos, guardar dados sobre uma determinada enti- 
dade do nosso sistema. 

A melhor maneira de provermos estas informações é no momento que criamos 
nossos objetos do tipo Livro. Para isso existe o método initialize que é cha- 
mado toda vez que executamos o método new afim de criar um objeto. 


teste e design = Livro.new("Mauricio Aniche", 247, "123454") 
web design responsivo = Livro.new("Tárcio Zemel", 189, "452565") 


Podemos até mesmo remover os parênteses: 


teste e design = Livro.new "Mauricio Aniche", 247, "123454" 
web design responsivo = Livro.new "Tárcio Zemel", 189, "452565" 
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Quando criamos uma classe, ganhamos automaticamente um método 
initialize default, para que o objeto possa ter suas informações inicializadas. 
Como queremos passar dados para inicializar nosso objeto de uma maneira 
diferente, no caso passando o nome do autor, número de páginas e ISBN, devemos 
implementar nosso próprio método initialize em nossa classe Livro: 


class Livro 
def initialize(autor, numero de paginas, isbn) 
end 

end 


Sobrescrevemos o método initialize default, criando um método cujo 
nome deve ser initialize. O método initialize é um método especial do 
Ruby, invocado pelo Livro .new para criar um novo objeto. Nesse momento, o 
Ruby aloca espaço em memória e depois invoca o método initialize passando 
os parâmetros necessários para criar o objeto. 

Agora vamos imaginar que existem alguns livros que não possuem o atributo 
isbn, o natural seria omitir o valor do isbn: 


teste e design = Livro.new "Mauricio Aniche", 247 


Isso não funciona, pois para a linguagem Ruby, a aridade do método é impor- 
tante, ou seja, devemos passar exatamente a quantidade de argumentos definido no 
método initialize. 

Se pensarmos em linguagens como Java, podemos definir um outro método 
initialize que recebe apenas o nome do autor e o número de páginas, recurso 
conhecido como sobrecarga : 


class Livro 
def initialize(autor, numero de paginas, isbn) 
end 


def initialize(autor, numero de paginas) 
end 
end 


Mas isso também não funcionará, pois o interpretador do Ruby considera apenas 
o último método definido na classe. Ruby não suporta sobrecarga. Para essa situação, 


a linguagem suporta o uso de argumentos com valores padrão: 
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class Livro 


def initialize(autor, numero de paginas, isbn = "1") 
end 
end 
Quando declaramos o argumento isbn = "1", definimos que no momento da 


inicialização dos objetos do tipo Livro, podemos omitir o último argumento: 


Livro.new "Lucas Souza", 198 


4 E 


O valor do argumento isbn é “1”. 
Agora vamos inverter a ordem dos argumentos do método initialize, colo- 
cando o atributo isbn antes do atributo numero de paginas e vamos também 


imprimir os valores de cada um dos argumentos: 


class Livro 
def initialize(autor, isbn = "1", numero de paginas) 
puts "Autor: #{autor}, ISBN: #{isbn}, Pág: (numero de paginas)" 
end 
end 


Livro.new "Lucas Souza", 200 


E o resultado é: Autor: Lucas Souza, ISBN: 1, Páginas: 200. 
Veja que o Ruby é esperto e consegue atribuir o valor 200 ao atributo 
numero de paginas e não ao atributo isbn. Isso ocorre porque a linguagem 


Ruby possui três tipos de argumentos: 


e Obrigatórios; 
e Com valores padrão; 


e Opcionais. 


Vimos dois deles até o momento: Obrigatório e com valores padrão. Veremos 
sobre os atributos opcionais nos próximos capítulos. Mas vamos ao que interessa, 
como o Ruby consegue descobrir para qual atributo deve atributo os valores da cha- 
mada ao método initialize? 

Quando um método recebe a chamada, o interpretador divide a atribuição dos 


valores em alguns passos. Primeiro ele procura todos argumentos obrigatórios e 
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associa os valores a estes, caso não encontre valor para algum destes atributos um 





erro do tipo ArgumentException acontece. Em seguida, se ainda existirem valo- 
res sobrando, estes são atribuídos aos argumentos default que existirem no método. 
Caso sobre apenas 1 valor, e existirem dois argumentos com valores default, o Ruby 
atribuirá o valor restante para o primeiro argumento com valor default. 


3.2 CRIE A ESTRUTURA DO PROJETO 


O código final do projeto que será construído foi disponibilizado no meu github: 

https://github.com/lucasas/projeto-ruby 

Agora, é importante que seja criada a estrutura básica do projeto, que facilitará a 
alteração das classes que serão criadas ao longo dos capítulos. O ideal é que somente 
os testes sejam feitos utilizando o IRB e todas as outras classes e códigos fiquem 
dentro do projeto. 

Crie uma pasta chamada loja virtual em um diretório de sua preferência 
e dentro deste diretório loja virtual crie uma pasta chamada 1ib. Dentro do 
diretório 1ib serão criados os arquivos que representam as classes do sistema, como 
por exemplo, a classe Livro que podemos transferir para lá agora mesmo. 

Crie um arquivo chamado livro.rb dentro da pasta lib com o conteúdo 
atual que definimos no IRB: 


class Livro 
def initialize(autor, isbn = "1", numero de paginas) 
puts "Autor: #{autor}, ISBN: #{isbn}, Pág: (numero de paginas)" 
end 
end 


Agora que a classe Livro foi colocada em um arquivo separado precisamos al- 
terar a maneira que os testes desta classe serão feitos. Quando um IRB é aberto o 
arquivo lib/livro.rb não é carregado automaticamente, você pode validar ten- 
tando criar um objeto Livro abrindo um novo terminal: 


Livro.new "Lucas Souza", 200 
# => NameError: uninitialized constant Livro 


Para carregar o conteúdo do arquivo lib/livro.rb é necessário utilizar o 
método require da classe Kernel. O método require recebe como parâmetro 
uma String que pode ser o nome do arquivo .rb que você deseja carregar. Se o 
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parâmetro não for o caminho absoluto do arquivo . rb o mesmo será procurado em 
diretórios que estão definidos na constante $LOAD PATH. 

O arquivo lib/livro.rb não está em nenhum dos diretório listados em 
$LOAD PATH, que em geral, contém os diretórios onde estão os arquivos .rb 
das classes core do Ruby. Sendo assim temos dois caminhos para fazer com que o 
Ruby consiga carregar o arquivo que contém a classe Livro. O primeiro é adicionar 
na constante $LOAD PATH, que é um objeto Array, o diretório 1ib do projeto 
loja virtual: 


$LOAD PATH << "caminho relativo do projeto loja_virtual/lib" 


Ao executar este código, o require pode ser feito apenas com o nome do ar- 
quivo da pasta 1ib que desejamos carregar: 


require 'livro' 


A segunda opção, e melhor na minha opinião, é carregar o arquivo passando o 
seu caminho absoluto. Porém, isso pode ser um pouco custoso já que você pode 
simplesmente resolver alterar o nome da pasta de loja virtual para loja. 





O ideal é utilizar o método expanda path da classe File que retorna o cami- 
nho absoluto de um nome de arquivo passado como parâmetro, levando em con- 
sideração o diretório onde a chamada do método é executado. Supondo que o 
arquivo livro.rb esteja dentro da pasta lib, que por sua vez esta dentro do 


diretório '/home/lucas/loja virtual" ao executar a chamada ao método 





expand. path dentro deste diretório passando a String ‘lib/livro’ o retorno do 
método será '/home/lucas/loja_virtual/lib/livro!: 





# executando a partir do diretório /home/lucas/loja virtual 
puts File.expand path("lib/livro") 
# => "/home/lucas/loja_virtual/lib/livro" 


Exatamente o diretório onde se encontra o arquivo livro.rb. 

Agora para testar a classe Livro como fizemos na seção anterior, basta abrir um 
novo IRB no diretório loja virtual e invocar o método require passando o 
caminho absoluto do arquivo livro.rb: 


# executando a partir do diretório /home/lucas/loja virtual 
require File.expand path("lib/livro") 


# objeto Livro criado com sucesso 
Livro.new "Lucas Souza", 200 
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A partir de agora, todos as novas classes serão colocadas dentro de arquivos . rb 
na pasta 1ib. E os testes serão feitos no IRB, lembrando que deve ser sempre aberto 
a partir do diretório loja virtual. E claro, é necessário carregar, utilizando o 
método require, todas as classes que serão utilizadas no teste. 

Outra dica importante: quando for necessário criar classes novas, haverá uma 
indicação dos procedimentos que deverão ser feitos para que a mesma possa ser 
testada. Quando houver alteração em classes já existentes, basta editar o conteúdo 
da classe dentro de seu respectivo arquivo .rb. E lembre-se o projeto pode final 
com a implementação completa pode ser encontrado no github: 

https://github.com/lucasas/projeto-ruby 





ENCODING ARQUIVOS .RB 


Os arquivos que contém as classes criadas em nosso sistema, ficarao 
em arquivos .rb dentro de um diretório de sua preferência. Porém é 
importante ressaltar que arquivos . rb possuem um encoding US-ASCII 
por padrão. Caso seu código contenha qualquer caractere que não for 
compatível com o ASCII, a interpretador Ruby será finalizado e acusará 
o erro: invalid multibyte char (US-ASCII). 





Se você quiser alterar o encoding padrão do arquivo . rb, basta adi- 
cionar a seguinte linha do arquivo: 


# encoding: utf-8 


Neste exemplo, ajustamos o encoding do arquivo para UTF-8, que 
permitira que vocé use acentos e outros caracteres. 











3.3 DEFINA OS ATRIBUTOS DE INSTÂNCIA 


Os parâmetros passados para o método initialize são na verdade variáveis lo- 
cais, ou seja, assim que terminar a execução do método, as variáveis locais simples- 
mente desaparecem. 

Vamos precisar as informações do autor, número de páginas e ISBN para traba- 
lhar com elas mais adiante nos nossos programas. Queremos que a informação dos 
livros acompanhem o objeto que vai ser instanciado. Para resolver este problema 
precisamos copiar o valor destes parâmetros para variáveis de instância de cada ob- 
jeto. Este comportamento é muito comum quando criamos métodos construtores. 
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Então vamos copiar os valores dos parâmetros do método initialize para 
variáveis de instância: 


class Livro 
def initialize(autor, isbn = "1", numero de paginas) 
@autor = autor 
@isbn = isbn 
@numero_de_paginas = numero_de_paginas 
end 
end 


Repare que as variáveis de instância tem um caractere @ antes do nome. O im- 
portante aqui é percebermos que as variáveis podem ter nomes iguais, porém, variá- 
veis com @ são de instância e compõem o estado interno do objeto que está sendo 
criado, enquanto variáveis locais possuem um escopo mais curto, elas duram apenas 
até o término da execução do método. 





VISIBILIDADE DAS VARIÁVEIS DE INSTÂNCIA 


Em Ruby, todas as variáveis de instância criadas são privadas, ou seja, 
não possuem acesso externo, nem para leitura, nem para escrita. Se qui- 
sermos acessá-las, vamos utilizar recursos da própria linguagem, que ve- 
remos nas próximas seções. 











Vamos testar o método initialize que agora guarda os parâmetros em va- 
riáveis de instância: 


teste e design = Livro.new("Mauricio Aniche", "123454", 247) 
web design responsivo = Livro.new("Tárcio Zemel", "452565", 321) 


p teste e design 
p web design responsivo 


O código acima produz a seguinte saída: 


#<Livro:0x007fa526012048 @autor="Mauricio Aniche", @isbn="123454", 
@numero_de_paginas=247> 

#<Livro:0x007fa526012049 @autor="Tarcio Zemel", @isbn="452565", 
@numero_de_paginas=321> 
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PUTS OU P? 


Quando precisamos imprimir informações no console em Ruby, po- 
demos utilizar os métodos puts ou p. A primeira delas já havíamos 
visto, o método puts. No exemplo de código onde testamos nossas va- 
riáveis de instância, usamos o método p. 

O método puts imprime o retorno do método to s do objeto que 
foi passado para ser impresso. Isto é, caso você faça puts variavel, 
é como se ele mostrasse o valor de variavel.to s, método que vere- 
mos logo em seguida. Já o método p é mais utilizado quando queremos 
realizar o debug do conteúdo do objeto passado como argumento. Nesse 
caso, o método inspect do objeto é invocado e o retorno é impresso 
na tela. Quando o conteúdo das variáveis de instância são impressas, é 
porque o método inspect da classe Livro retorna os valores de todas 
as variáveis do objeto criado. 











3.4 SOBRESCREVENDO O MÉTODO ro s 


Convenhamos que o resultado impresso não é o ideal, podemos retornar uma men- 
sagem mais agradável caso algum usuário do nosso código instancie e queira ver 
informações mais coerentes sobre uma instância de Livro. 

Aliás, exibir uma mensagem amigável ao “imprimir um objeto é considerado 
uma boa prática. Esse assunto é inclusive capítulo de um livro muito conhecido na 
comunidade Java, chamado Effective Java, escrito por Joshua Bloch, hoje engenheiro 
do Google. 

Em Ruby podemos aplicar a mesma prática sobrescrevendo o método to s, 
que é herdado naturalmente por todas as classes, pois faz parte da classe Object, e 
fazendo com que ele devolva uma String: 


# coding: utf-8 
class Livro 
def initialize(autor, isbn = "1", numero_de_paginas) 
@autor = autor 
@isbn = isbn 
@numero_de_paginas = numero_de_paginas 
end 
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def to s 


"Autor: #{@autor}, Isbn: #{@isbn}, Páginas: t(Onumero de paginas)" 


end 
end 


Uma novidade nesse código é que em Ruby, quando desejamos retornar um de- 
terminado valor não precisamos explicitamente colocar a palavra return antes do 
valor que desejamos retornar, o retorno de qualquer método escrito em Ruby sempre 
será a última instrução de código (veremos este comportamento com mais detalhes 
no capítulo “Ruby Funcional). Se a última instrução de um método for, por exem- 
plo,a String "Um texto qualquer", ao invocarmos este método receberemos 
como retorno do método a própria String Um texto qualquer. Porém, em 
algumas ocasiões o uso da palavra return é necessário, dependendo da lógica que 
estamos implementando, mas lembre-se que ele nunca é obrigatório. 

Lembre-se que o método to. s é invocado quando utilizamos o método puts. 
Portanto vamos alterar o código que testa a criação dos objetos com suas variáveis 
de instância: 


teste e design = Livro.new("Mauricio Aniche", "123454", 247) 
web design responsivo = Livro.new("Tárcio Zemel", "452565", 321) 


puts teste e design 
puts web design responsivo 


Agora o código acima produz a seguinte saída: 


Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247 
Autor: Tárcio Zemel, Isbn : 452565, Páginas: 321 


A mensagem está muito mais elegante e concisa. Lembre-se, sobrescrever o mé- 
todo to s sempre é uma boa prática quando queremos criar uma mensagem mais 
elegante que descreva o estado interno dos objetos. 


3.5 ALTERAÇÃO E LEITURA DE ATRIBUTOS 
3.5. ALTERAÇÃO E LEITURA DE ATRIBUTOS 


Para que nossos livros possam ser vendidos, precisamos que eles tenham um atributo 
que contém seu preço. Para isso vamos adicionar um novo argumento no método 
initialize da classe Livro e guardar seu valor em uma variável de instância 
chamada @preco: 
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# coding: utf-8 
class Livro 
def initialize(autor, isbn = "1", numero_de_paginas, preco) 
@Gautor = autor 
Gisbn = isbn 
@numero_de_paginas = numero_de_paginas 
@preco = preco 
end 


def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, Páginas: #{@numero_de_paginas}" 
end 
end 


E podemos instanciar novos livros informando o preço: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 


Agora para todos os objetos do tipo Livro que foram criados, desejamos tam- 
bém saber seu preço. Mas lembre-se que as variáveis de instância são sempre pri- 
vadas, ou seja, só conseguimos acessá-las dentro da classe Livro. A solução neste 
caso é criar um método público que retorne o valor da variável @preco: 


# coding: utf-8 
class Livro 


# outros métodos 


def preco 
@preco 
end 
end 


Agora, dada qualquer instância de um Livro, podemos invocar o método 


preco que retornará o valor da variável @preco: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
puts teste e design.preco # => 60.9 


Repare que fizemos um método com o mesmo nome da variável. Essa é uma 
convenção utilizada pelos desenvolvedores Ruby, onde o método que acessa a variá- 
vele a própria variável possuem o mesmo nome. 
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O Brasil é um país que possui inflação que gira em torno de 6% a 7% ao ano. 
Em nossa aplicação, permitiremos que os nossos livros sofram alterações de preços 
também. Dessa forma, dada uma instância do tipo Livro desejamos alterar seu 


preço: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
teste e design.preco = 79.9 
# => NoMethodError: undefined method ~preco=' for 

Autor: Mauricio Aniche, Isbn: 123454, Paginas: 247:Livro 


Lembre-se novamente, as variáveis de instância são sempre privadas. Então por 
enquanto não conseguimos alterar o preço de um objeto Livro. A solução é criar- 
mos um método público que recebe o novo preço do livro como argumento e atribua 
este preço a variável que guarda o valor do nosso livro, @preco: 


# coding: utf-8 
class Livro 


# outros métodos 


def preco 
@preco 
end 


def preco=(preco) 
@preco = preco 
end 
end 


Podemos ver outra convenção para criar código Ruby mais legível. Os métodos 
que alteram o valor de variáveis de instância costumam ter o nome da variável sem 
o e, com um sinal de = e a declaração dos argumentos do método. Mas lembre-se 
que isso é uma convenção. 

Para alterar o preço de uma instância do tipo Livro podemos agora invocar o 


método preco=: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
teste e design.preco=(79.9) 


puts teste e design.preco 
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Ao executarmos o código acima, veremos que o novo preço do livro é 79.9. 
Mas podemos deixar nosso código mais simples. Remover os parênteses é um bom 
caminho para melhorar a legibilidade: 


teste e design.preco=79.9 


Quando definimos métodos que possuem sinal de = em sua nomenclatura, po- 


demos adicionar um espaço na chamada do método: 


teste e design.preco = 79.9 


Diferença sutil, mas que deixa a sensação de que estamos alterando o valor da 
variável diretamente. Nosso código está legível, mas podemos melhorá-lo utili- 
zando a própria linguagem Ruby. Como criar métodos que acessam e modificam 
os valores de uma variável de instância é uma tarefa bastante comum, os criado- 
res da linguagem pensaram em facilitar este processo e criaram: attr writer e 
attr reader. 

Esses métodos podem receber vários argumentos do tipo Symbol. Cada sím- 
bolo representa o nome da variável que desejamos expor para leitura ou escrita: 


# coding: utf-8 

class Livro 
attr_writer :preco 
attr_reader :preco 


# outros métodos 
end 


Quando chamamos o método attr writer passando o símbolo :preco, 
automaticamente os objetos do tipo Livro passam a ter um método preco=. O 
mesmo acontece quando chamamos o método attr reader, neste caso os objetos 


passam a ter um método preco: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
teste e design.preco = 79.9 
puts teste e design.preco 


Se você deseja criar um par de métodos, um de leitura e outro de escrita para 
uma determinada variável de instância, existe uma maneira mais simples do que 
utilizar os métodos attr readere attr writer. Com esse intuito, o método 


attr accessor foi criado: 
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# coding: utf-8 
class Livro 
attr_accessor :preco 


# outros métodos 
end 


O attr_accessor atua como um substituto para os métodos attr_writer 
e attr_reader. Quando o usamos, definimos um método de leitura e um outro 
de escrita seguindo a convenção da linguagem. 

Com isso os métodos preco e preco= que haviam sido definidos manual- 
mente, podem ser removidos. 


Símbolos 


Símbolos são palavras que parecem com variáveis, eles podem conter letras, nú- 
meros e _. Símbolos são String mais leves e geralmente utilizados como identifi- 
cadores. 

A verdade é que símbolos são strings, como uma diferença importante, eles são 
imutáveis, ou seja, seu valor interno não pode ser alterado. Por isso geralmente os 
utilizamos como identificadores. 


“um simbolo qualquer .object id == :um simbolo qualquer.object id 

# true 

"um_simbolo_qualquer".object_id == "um simbolo qualquer".object id 
# false 


Veja que independente da quantidade de vezes que referenciamos um símbolo, 
ele sempre será o mesmo objeto (o método object. id retorna o um identificador 
do objeto na memória). Já no caso das String, mesmo sendo exatamente iguais, 
são objetos diferentes na memória. Como String são imutáveis, cada objeto tem 
seu próprio espaço em memória, quando elas não são mais referenciadas, poderão 
ser coletadas pelo coletor de lixo (Garbage Collector - GC). 

Já os símbolos, por terem um única instância na memória, nunca serão coleta- 
dos pelo GC. Além disso, símbolos não são guardados somente na memória, eles 
também ficam em um dicionário de símbolos otimizado pelo interpretador. 


3.6 ATRIBUTOS NEM TÃO PRIVADOS ASSIM 
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3.6. ATRIBUTOS NEM TÃO PRIVADOS ASSIM 


Umas das características de variáveis de instância é que elas são privadas, ou seja, 
seu valor não pode ser alterado de fora da classe, apenas com métodos públicos que 
internamente em sua implementação alteram o valor da variável. Vimos isso quando 
precisamos alterar o valor da variável preco. 

Infelizmente, existem maneiras de burlar estas restrições, e uma vez que temos 
em mãos a instância de um objeto qualquer, podemos ler e alterar o valor das variá- 
veis de instância. 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
puts teste e design. instance variable get "@preco" # => 60.9 


O método instance variable get retorna o valor de uma variável de ins- 
tancia qualquer. Basta passar como argumento o nome da variável com o @. No 
código acima, o resultado será 60.9. Ler o valor da variável não é tão problemático 
se compararmos com o fato de que podemos alterar o valor de qualquer variável de 
instância também: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
teste e design. instance variable set "@preco", 75.5 
puts teste e design.preco # => 75.5 


O método instance variable set recebe dois argumentos, o primeiro é 
o nome da variável de instância que você deseja alterar, o segundo o valor que você 
deseja atribuir à variável. 

Os métodos instance variable set e instance variable get são 
métodos herdados por todos os objetos Ruby. Eles pertencem a classe Object, 
que é a classe pai da hierarquia de classes que temos na linguagem. Esses métodos 
nos apesentam o começo de um assunto muito discutido e poderoso da linguagem 
conhecido como meta-programação. 


3.7 GRANDES PODERES, GRANDES RESPONSABILIDADES 
3.7. GRANDES PODERES, GRANDES RESPONSABILIDADES 


Os métodos que vimos na seção anterior, podem parecer muito poderosos em uma 
primeira impressão. Porém, com o tempo e dependendo do tamanho do projeto 
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podem nos trazer grandes dores de cabeça. Vamos tomar como exemplo a nossa 
classe Livro: 


# coding: utf-8 
class Livro 
attr_accessor :preco 


def initialize(autor, isbn = "1", numero_de_paginas, preco) 
@Gautor = autor 
Gisbn = isbn 
@numero_de_paginas = numero_de_paginas 
@preco = preco 
end 


def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, Páginas: #{@numero_de_paginas}" 
end 
end 


Você sentindo-se o Peter Parker da vida real, resolve alterar o valor de alguma 
variável usando o instance variable set: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
teste e design.instance variable set "@preco", 75.5 
puts teste e design.preco # 75.5 


Depois de alguns anos, você decide casar-se com Mary Jane e abandonar sua vida 
de homem aranha e também o desenvolvimento de software. O projeto é assumido 
por outro desenvolvedor que resolve alterar o nome da variável preco para valor: 


# coding: utf-8 
class Livro 
attr_accessor :valor 


def initialize(autor, isbn = "1", numero_de_paginas, valor) 
Gautor = autor 
Gisbn = isbn 
@numero_de_paginas = numero_de_paginas 
@valor = valor 
end 


def to_s 
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"Autor: #{@autor}, Isbn: #{@isbn}, Páginas: &(Qnumero de paginas)" 
end 
end 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
puts teste e design.preco 
# => NoMethodError: undefined method “preco! 

for Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247:Livro 





A chamada ao método preco retornará o erro: NoMethodError, obviamente 


porque o método agora se chama valor: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9 
puts teste e design.valor 


Porém o antigo desenvolvedor homem aranha deixou em algum lugar do sistema 


uma chamada ao instance variable set: 


teste e design. instance variable set "@preco", 75.5 
puts teste e design. instance variable get "@preco" 


O problema é que além de tentarmos alterar o valor da uma variável que não 
existe mais, o código acima é silencioso, não retorna nenhum erro avisando que 
aquela variável não existe, pelo contrário, ele cria uma variável nova chamada 
@preco que não tem relação alguma com nosso domínio, já que quando a variá- 
vel não existe, ao tentarmos acessá-la ela será criada. 

O código tornou-se obsoleto, se não existirem testes de unidade que validem este 
comportamentos, provavelmente ele seria observado somente em produção quando 
algum cliente usasse o sistema. 

A dica é simples aqui, se a variável de instância é privada, mesmo que a lingua- 
gem lhe permita burlar essa característica, não faça, resolva o problema de outra 
maneira. Certamente existirá algum método na interface pública do seu objeto que 


faça por você a alteração da variável de uma forma segura e correta. 
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Estruturas de dados 


Ruby possui trés tipos de estruturas de dados que veremos com detalhes neste ca- 
pitulo. Cada uma destas estruturas possui suas qualidades e defeitos, que vamos 
explorar daqui em diante. 


4.1 TRABALHE COM ARRAYS 


Arrays em Ruby são coleções indexadas, ou seja, guardam objetos em uma determi- 
nada ordem e disponibilizam métodos que permitem acessar objetos destas coleções 
através do seu índice. Diferente do que acontece com a linguagem C ou Java, onde 
precisamos definir arrays com uma quantidade máxima de objetos, em Ruby os ar- 
rays não precisam ter seu tamanho pré definido, eles crescem conforme a necessi- 
dade. 

Existem varias formas de definir um Array em Ruby, sendo que a mais simples 
é utilizando []: 


numeros = [1, 2, 3] 
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puts numeros.class # => Array 


Criamos um objeto do tipo Array utilizando dois colchetes e separando os vá- 
rios elementos do Array com a vírgula. Para acessar os elementos de um Array, 
utilizamos o método [indice] que recebe como argumento a posição do elemento 
que desejamos acessar, lembrando que em Ruby os índices começam em o: 


numeros = [1, 2, 3] 

puts numeros[0] & => 1 
puts numeros[1] & => 2 
puts numeros[2] & => 3 


Quando precisamos acessar o primeiro ou o último elemento podemos fazê-lo 
através de métodos ( first e last) da classe Array: 


numeros = [1, 2, 3] 
puts numeros.first # => 1 
puts numeros.last # => 3 


Como Ruby é uma linguagem com tipagem dinâmica, podemos adicionar ob- 
jetos (adicionar novos elementos em um array se dá através do método <<, bem 
parecido com um append, que adicionará o novo elemento no final do Array) de 
qualquer tipo dentro de um mesmo Array: 


numeros = [1, 2, 3] 

numeros << "ola" 

puts numeros # [1, 2, 3, "ola"] 
# => 1, 2, 3, "ola" 


O problema de adicionar qualquer tipo de objeto dentro de um Array, é que 
muitas vezes não sabemos qual o objeto que estamos lidando. Por exemplo, vamos 
definir um método que recebe um Array como argumento, busca pelo primeiro 
elemento, o multiplica por 2 e por fim imprime o resultado na tela: 


def multiplica primeiro elemento por dois (numeros) 
puts 2 * numeros .first 
end 


multiplica primeiro elemento por dois [1, 2, 3] # 2 


multiplica primeiro elemento por dois ["abc", 2, 3] 
# => TypeError: String can't be coerced into Fixnum 
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Veremos que existem vantagens na tipagem dinâmica das estruturas de dados 
em Ruby nos próximos capítulos. 
A criação de array de strings 


Para criar um Array de strings, a sintaxe utilizada pode ser a mesma que usamos 


para criar um array com outros tipos de elementos: 


palavras = ['ola', 'mundo'] 
p palavras # => ["ola", "mundo"] 


Existe uma sintaxe mais simples para criar um array de palavras: 


palavras = %w{ola mundo} 
p palavras # => ["ola", "mundo"] 


A vantagem de usar o %w{} é poder separar as palavras que compões o Array 
utilizando espaço e não vírgula, assim poluindo pouco o código. Podemos utilizar 
também o %W{}, que permite a interpolação de valores nas palavras que compõe o 
array: 


nome = "Lucas" 
palavras = %W{ola #{nome}} 
p palavras & ["ola", "Lucas"] 


4.2 GUARDANDO NOSSO LIVROS 


Aproveitando que agora conhecemos um pouco de uma estrutura de dados Ruby, 
vamos guardar as instâncias dos objetos Livro que criamos dentro dela. 


biblioteca = [] 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 70.5 
web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 67.9 


biblioteca << teste e design 
biblioteca << web design responsivo 


puts biblioteca 


# => Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247 
# => Autor: Tarcio Zemel, Isbn : 452565, Páginas: 321 
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Hoje, decidimos que vamos guardar os objetos dentro deum Array, mas futura- 
mente podemos descobrir outra estrutura que funcione melhor, seja mais rápida ou 
forneça vantagens queo Array não oferece. Se optarmos por essa mudança, teremos 
que procurar todos os lugares que instanciam objetos do tipo Livro, guardando-os 
dentro de um array, e adaptar o código para a maneira da nova estrutura. 

Para nos protegermos desse problema, podemos isolar o código que faz essa atri- 
buição em um único ponto, que será invocado em outras partes do código. Assim, 
alteramos em um só lugar e o sistema inteiro está modificado. Essa conceito chama- 
se encapsulamento. 

Vamos isolar este comportamento de guardar livros dentro de um array, em 
uma classe que podemos chamar de Biblioteca, e quando houver a necessidade 
de mudarmos de Array para alguma outra estrutura, faremos em apenas um lu- 
gar. Adicione a definição da classe Biblioteca dentro de um arquivo chamado 
biblioteca.rb dentro do diretório lib: 


class Biblioteca 
def initialize 
@livros = [] 
end 


def adiciona(livro) 
Olivros << livro 
end 
end 


Agora para guardar os livros que criamos, não vamos criar um Array e apendar 
os valores diretamente nele. Criaremos um objeto do tipo Biblioteca e chama- 
remos o método responsável por adicionar novos livros na biblioteca. Porém, para 
testar a classe Biblioteca é necessário carregar o arquivo que contém sua defini- 


ção: 


require File.expand_path('lib/livro') 
require File.expand_path('lib/biblioteca') 


Ao passar do tempo, os arquivos necessários para efetuar os testes serão um 
maior número. Para não dificultar os testes, vamos criar um único arquivo que fará o 
require de todos os outros. Vamos chamá-lo de loja virtual.rb e adicioná- 
lo no diretório 1ib da pasta loja virtual. Dentro dele faremos o carregamento 
dos arquivos biblioteca.rbe livro.rb: 
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require File.expand_path('lib/livro') 
require File.expand_path('lib/biblioteca') 


Agora para efetuar os testes basta executar um Unico require, do arquivo 


loja_virtual.rb: 
require File.expand_path('lib/loja_virtual') 
E executar os testes da classe Biblioteca: 


biblioteca = Biblioteca.new 


teste_e_design = Livro.new "Mauricio Aniche", "123454", 247, 70.5 
web_design_responsivo = Livro.new "Tarcio Zemel", "452565", 189, 67.9 


biblioteca.adiciona teste_e_design 
biblioteca.adiciona web_design_responsivo 


Se precisarmos acessar quais são os livros que existem dentro da nossa biblioteca, 
basta expor a variável Glivros através do attr reader: 


class Biblioteca 
attr reader :livros 


def initialize 
@livros = [] 
end 


def adiciona(livro) 
@livros << livro 
end 
end 


E para acessar as variáveis, podemos chamar o método livros na 


Biblioteca: 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 70.5 
web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 67.9 


biblioteca.adiciona teste e design 
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biblioteca.adiciona web design responsivo 


p biblioteca.livros 
# => [Autor: Mauricio Aniche, Isbn: 1, Páginas: 247, 
Autor: Tárcio Zemel, Isbn: 1, Páginas: 189] 


4.3 PERCORRENDO MEU ARRAY 


No capítulo 2, aprendemos algumas estruturas de controle, entre elas o for, que 
serve para iterarmos sobre ranges, e também coleções como o Array. O método 
livros do objeto biblioteca, retorna todos os livros em formato de Array. Para 
acessar cada livro deste array, basta iterarmos através do for: 


biblioteca = Biblioteca.new 
# popula a biblioteca 


for livro in biblioteca.livros do 
p livro.valor 


end 
# => 70,5 
# => 67.9 


4.4 COMO SEPARAR OS LIVROS POR CATEGORIA: TRABA- 
LHE COM HASH 


A medida que nossa biblioteca cresce, precisamos separar os livros dentro da bibli- 
oteca por categorias. Dessa forma, o primeiro passo para fazermos essa separação é 
adicionarmos um atributo chamado categoria à classe Livro: 


# coding: utf-8 

class Livro 
attr_accessor :valor 
attr_reader :categoria 


def initialize(autor, isbn = "1", numero_de_paginas, valor, 
categoria) 
Gautor = autor 
Gisbn = isbn 
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Qnumero de paginas = numero de paginas 
@valor = valor 
@categoria = categoria 


end 
def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: &(Qnumero de paginas), Categoria: #{@categoria}" 
end 


end 


A categoria do livro será um Symbol, como: :ruby, :testes, :html, 
: javascript, :ios etc. Os livros que criamos anteriormente recebem um ar- 


gumento a mais, contendo a sua respectiva categoria: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
«testes 
puts teste e design.categoria # => :testes 


Agora que cada livro possui sua categoria, vamos adaptar nossa classe 
Biblioteca para guardá-los. Dessa forma, a classe Biblioteca terá a organi- 
zação de categorias. 

Os arrays guardam os elementos sequencialmente e não existe nenhuma divisão 
destes elementos. Precisamos de uma estrutura que suporte este tipo divisão, um 
número N de objetos em um determinado container, sendo possível termos vários 
containers também. 

Vamos utilizar um Hash, estrutura que guarda sempre uma chave (identificador 
único, que geralmente é um símbolo) e um valor (que pode ser qualquer tipo de 
objeto Ruby). Sua inicialização é feita utilizando {}: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
:testes 


web_design_responsivo = Livro.new "Tarcio Zemel", "452565", 189, 70.9, 
:web_design 


hash = {"123454" => web_design_responsivo, 
"452565" => web_design_responsivo} 


O hash acima possui dois containers, um cujo identificador é a String 
"123454", que corresponde ao isbn do objeto teste e design, e outro 
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cujo identificador é a String "452565", que corresponde ao isbn do ob- 
jeto web design responsivo. Cada um destes containers possui um deter- 
minado valor, no Hash acima o container “123454” possui como valor o objeto 
teste e design, já o container, cujo identificado é “452565”, possui como valor o 
objeto web design responsivo 

Quando desejamos acessar o valor que está incluso dentro um Hash, basta in- 


vocarmos o método [:chave] passando a chave identificadora do container: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
“testes 


web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
:web design 


hash = { "123454" => web design responsivo, 
"452565" => web design responsivo + 


p hash["123454"] 
# => Autor: Tárcio Zemel, Isbn: 452565, Páginas: 189, 
Categoria: web design 


Bem parecido com a maneira que acessamos valores dentro de um Array. A 
diferença é que passamos um objeto que representa a chave identificadora, e não um 
Integer que representa o índice, como acontece quando acessamos valores de um 
Array. 

Agora vou provar que o encapsulamento que fizemos ao definir a classe 
Biblioteca nos ajudará a migrar sem sofrimentos de Array para Hash a es- 
trutura que guardava os livros: 


class Biblioteca 
attr reader :livros 


def initialize 
@livros = {} & Inicializa com um hash 
end 


def adiciona(livro) 
@livros[livro.categoria] ||= 0 
@livros[livro.categoria] << livro 
end 
end 
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O código que instancia os livros e os guarda dentro da biblioteca, continua fun- 


cionando. 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", 247, "123454", 
itestes 


web design responsivo = Livro.new "Tárcio Zemel", 189, "452565", 
:web design 


biblioteca.adiciona teste e design 
biblioteca.adiciona web design responsivo 


O problema agora é o método que utilizamos para retornar os livros que estão 
dentro da nossa biblioteca, retornam um Hash e não maisum Array ea forma de 
iterar sobre estas duas estruturas de dados são diferentes. A primeira opção é fazer 


com que o método livros continue retornando um Array: 


class Biblioteca 
def adiciona(livro) 
@livros[livro.categoria] ||= [] 
@livros[livro.categoria] << livro 
end 


def livros 
Olivros.values.flatten 
end 
end 


Criando nossa própria implementação do método livros, conseguimos man- 
ter o mesmo comportamento anterior, quando retornávamos um array diretamente. 
A segunda opção para resolver o problema, é retornar um Hash e alterar a forma 
que iteramos sobre o retorno no método livros: 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 


web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
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:web design 


biblioteca.adiciona teste e design 
biblioteca.adiciona web design responsivo 


for categoria, livros in biblioteca.livros do 
p categoria 


for livro in livros do 
p livro.valor 


end 
end 
# => testes 
# => 60.9 
# => :web_design 
# => 70.9 


A diferença é que o método for recebe dois argumentos, a chave e o valor do 
hash. Em nosso exemplo, a chave é a categoria da estante de livros ( :testes, 
por exemplo), e valor é um array com os livros desta categoria. 


Os métodos values e flatten 


Quando precisamos obter todos os valores de um determinado hash, indepen- 
dente do container, utilizamos o método values (que retorna todos os valores do 
hash dentro de um Array): 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
“testes 


web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
:web design 


hash = { testes: teste e design, web design: web design responsivo + 
p hash.values # [teste e design, web design responsivo] 


No caso da classe Biblioteca, nós guardamos conjuntos de livros dentro de 
Array, sendo um Array para cada categoria. Quando os valores de um hash são 
do tipo Array, o método values retornará um novo Array com vários Array 
dentro, o que pode não ser um resultado muito interessante para trabalharmos, veja: 
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teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 

web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
“web. design 


hash = { testes: [teste e design], web design: [web design responsivo]+ 
p hash.values 
# => [Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247, 
Categoria: testes], 
[Autor: Tárcio Zemel, Isbn: 452565, Páginas: 189, 
Categoria: web design] 


Precisamos que o retorno do método livros seja um único Array com to- 
dos os livros existentes dentro da Biblioteca independente da categoria deles. 
Podemos alcançar nosso objetivo utilizando o método flatten: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 

web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
“web. design 


hash = { testes: [teste e design], web design: [web design responsivo]+ 


p hash.values.flatten 
# => [Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247, 
Categoria: testes, 
Autor: Tárcio Zemel, Isbn: 452565, Páginas: 189, 
Categoria: web design] 


O método flatten procura por objetos do tipo Array dentro do Array 
onde o método foi chamado (em nosso exemplo o Array retornando pelo método 
values), extrai esses valores e retorna um novo Array com todos os elementos 
extraídos. É importante ressaltar que o método flatten é recursivo, se o invocar- 
mos em um Array, que possui vários outros objetos do tipo Array, que por sua 
vez sejam formados por alguns outros objeto que também sejam Array, ele recur- 
sivamente extrairá os elementos de todos eles e retornará os elementos em um novo 
objeto Array. 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
:testes 
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web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
:web design 

jsf.e jpa = Livro.new "Gilliard Cordeiro", "543465", 234, 64.9, 
:frameworks mvc 


hash = {} 
hash[:testes] = [ [ teste e design ], [ jsf e jpa ] ] 
hash[:web design] = [ [ web design responsivo ] ] 


hash.values.flatten 

# => [Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247, 
Categoria: testes, 

Autor: Gilliard Cordeiro, Isbn: 543465, Páginas: 234, 
Categoria: frameworks mvc, 

Autor: Tárcio Zemel, Isbn: 452565, Páginas: 189, 
Categoria: web design] 


Ke) 


4.5 INDO MAIS A FUNDO: HASHES NO RUBY 1.9 


A chave identificadora de um objeto Hash pode ser um objeto de qualquer tipo 
( String, Integer, Livro, etc). Porém o mais comum é definirmos as chaves 
como Symbol, que são comumente utilizados para esta finalidade. Por exemplo: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
“testes 


web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
:web design 


hash = { :testes => [teste e design], 
:web design => [web design responsivo] } 


p hash[:testes] # => ["Autor: Mauricio Aniche, Isbn: 123454, 
Páginas: 247, 
Categoria: :testes"] 


Na versão 1.9 da linguagem Ruby foi introduzida uma nova sintaxe para declarar 
elementos em um hash quando a chave identificadora é um Symbol, muito parecida 
com a sintaxe da linguagem Javascript. Entretanto a forma que acessamos o valor de 
Hash continua sendo a mesma: 
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teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 

web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
“web. design 


hash = { testes: [teste e design], web design: [web design responsivo] + 
p hash[:testes] # => ["Autor: Mauricio Aniche, Isbn: 123454, 

Páginas: 247, 

Categoria: :testes"] 


4.6 INDO MAIS A FUNDO: O OPERADOR ||= 


Imagine que queremos setar o valor em uma determinada variável somente se o valor 
atual da mesma for nil, caso ela já esteja preenchida, o valor deve ser mantido: 


idade = nil 


idade = 27 unless idade 
puts idade # 27 


idade = 35 unless idade 
puts idade # 27 


Muito código para uma tarefa trivial. Por isso, os criadores do Ruby, fizeram o 
operador | |=, que executa o mesmo comportamento que implementamos com o 


unless: 
idade = nil 


idade | |= 27 
puts idade # 27 


idade | |= 35 
puts idade # 27 


4.7 INDO MAIS A FUNDO: O TIPO SET 


Quando trabalhamos com objeto do tipo Array, podemos repetir os mesmos ele- 
mentos quantas vezes acharmos necessário, por exemplo: 


numeros = [1, 2, 2, 3, 2, 1] 
p numeros # [1, 2, 2, 3, 2, 1] 
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Não existe nenhuma regra que proíba a duplicidade de elementos. Mas em certas 
ocasiões é necessário garantirmos que dentro de uma estrutura de dados existam 
elementos únicos, ou seja, sem repetição. Ruby contempla essa necessidade através 
de um outro tipo de coleção, chamada Set, que guarda valores em um ordem não 
definida (diferente de arrays) e garante a não duplicidade. 

A sintaxe usada para criarmos uma coleção do tipo set é um pouco diferente 
das que vimos até o momento: 


require 'set' 
numero sem repeticao = Set.new [1, 2, 2, 3, 2, 1] 


Quando precisamos utilizar o tipo Set, precisamos carregar o arquivo set .rb 
que foi instalado junto com o interpretador e as outras classes básicas da própria 
linguagem. O arquivo set .rb contém a classe Set. 

A classe Set possui um método initialize que recebe um Array com os 
elementos que formarão a coleção, ao receber este array, são guardados apenas os 
elementos não repetidos e descartados os restantes. Podemos verificar este compor- 
tamento iterando no Set que foi criado: 


require 'set' 


numero sem repeticao = Set.new [1, 2, 2, 3, 2, 1] 
for numero in numero sem repeticao do 


p numero 
end 

# => 1 

# => 2 

# => 3 


Vimos que a classe Set consegue “descobrir” quais são os elementos “iguais” e 
manter apenas um destes elementos. Isso funciona muito bem com os números, mas 
e se tentarmos adicionar várias instância de um mesmo Livro dentro de um Set. 
Vamos ver? 


require 'set' 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
«testes 
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web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
“web. design 


livros = Set.new [teste e design, web design responsivo] 
for livro in livros do 

p livro 
end 


p hash[:testes] # => ["Autor: Mauricio Aniche, Isbn: 123454, 
Páginas: 247, 
Categoria: :testes"] 


Repare que duas instâncias de livro compõem o Set. Isso ocorre porque para 
a linguagem Ruby, estes dois objetos são diferentes. Podemos verificar isso invo- 
cando e comparando o retorno do método object id (que retorna um identifica- 
dor único de cada objeto na memória) de cada um dos objetos: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 

web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
“web. design 


p teste e design.object id == web design responsivo.object id 
# => false 


Para garantirmos que dois objetos sao iguais por seus valores, devemos compara- 
los utilizando o método eql?: 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
itestes 


web design responsivo = Livro.new "Tárcio Zemel", "452565", 189, 70.9, 
:web design 


p teste e design.eql? web design responsivo 
# => false 


O retorna continua sendo false. Em nenhum momento definimos o método 
eq1?, na verdade ele foi um método herdado da classe Ob ject, e que em sua imple- 
mentação original compara os objetos através de seus object id. No momento 
em que decidirmos que o critério que define se um objeto é igual ao outro levará 
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outro valor em consideração, devemos sobrescrever o método eql? e fazermos a 
comparação que julgamos ser a adequada: 
# coding: utf-8 
class Livro 
attr_reader :isbn 


def eql?(outro_livro) 
Gisbn == outro_livro.isbn 
end 
end 


teste_e_design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
“testes 


web design responsivo = Livro.new "Tárcio Zemel", "123454", 189, 70.9, 
:web design 
p teste e design.eqgl? web design responsivo # => true 


Sobrescrevemos o método eql? e definimos que se um outro livro tiver o 
mesmo isbn que o livro que estamos comparando, eles são iguais. E importante 
salientar que não estamos dizendo que eles são os mesmos objetos na memória. 





==, EQUAL? OU EQL? 


O método == retorna true apenas se os dois objetos envolvidos 
na comparação forem a mesma instância, este é seu comportamento pa- 
drão. Ele pode ser sobrescrito afim de efetuar a comparação de outras 
maneiras. 

O método equal? é similar ao ==, ele retorna true apenas se os 
dois objetos envolvidos na comparação forem a mesma instância. As bi- 
bliotecas existentes na linguagem, quando tem a necessidade de compa- 
rar se dois objetos são a mesma instância usam o método equal?, por 
esse motivo, não devemos sobrescrever este método, pois o efeito pode 
ser bastante prejudicial. 

Por fim o método eql? por padrão compara as instâncias dos objetos 
também. Porém, este método deve ser sobrescrito quando desejamos 
avaliar se dois objetos são iguais por seus valores, como fizemos com a 


classe Livro. 
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Porém sobrescrever apenas o método eql? não é suficiente para evitarmos du- 
plicidade de objetos do tipo Livro dentro de uma coleção do tipo Set. Ainda não 
é suficiente, porque o Set internamente utiliza um Hash para guardar os valores e 
uma coleção do tipo Hash é um conjunto de buckets (container) com um rótulo e 
dentro uma determinada quantidade de objetos. 

O rótulo destes buckets são na verdade o retorno do método hash de um de- 
terminado objeto. No caso dos objetos do tipo Livro, o retorno do método hash 
quase sempre será diferente. Isso porque todo objeto possui uma implementação 
default do método hash que faz um cálculo com propriedades especificas do objeto 
em questão. 

Se quisermos evitar duplicidade dos objetos do tipo Livro dentro de um Set, 
devemos fazer com que instâncias que possuem o mesmo isbn (que é nosso critério 
de igualdade) tenham o mesmo retorno quando invocarmos o método hash: 


# coding: utf-8 
class Livro 
def hash 
@isbn.hash 
end 
end 


teste_e_design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
:testes 


web_design_responsivo = Livro.new "Tarcio Zemel", "123454", 189, 70.9, 
:web_design 
p teste_e_design.hash == web_design_responsivo.hash # => true 


O que fizemos foi retornar o valor do método hash do atributo string isbn. É 
sempre importante tomarmos cuidados quando redefinimos o método hash prin- 
cipalmente quando guardarmos vários objetos deste tipo dentro de Hashe Set. Se 
o valor do hash for pouco variável, podemos ter várias colisões de hash, o que pode 
ocasionar um busca muito mais lenta por esses elementos. 

Agora podemos testar que caso instancias diferentes da classe Livro tenham o 
mesmo isbn, eles não serão mais duplicadas dentro de um Set: 


require 'set' 


teste e design = Livro.new "Mauricio Aniche", "123454", 247, 60.9, 
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«testes 
web design responsivo = Livro.new "Tárcio Zemel", "123454", 189, 70.9, 
:web design 


livros = Set.new [teste e design, web design responsivo] 
for livro in livros do 

p livro 
end 


# => Autor: Mauricio Aniche, Isbn: 123454, 
Páginas: 247, Categoria: :testes 
4.8 E AGORA? 


No próximo capítulo veremos maneiras mais elegantes de iterarmos coleções, 
usando características funcionais da linguagem Ruby. Exploraremos diversos mé- 
todos úteis que existem nas APIs do Ruby. 
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CAPITULO 5 


Ruby e a programacao funcional 


Ruby é conhecida por ser uma linguagem relacionada ao paradigma Orientado a 
Objetos, porém, também possui suporte ao paradigma funcional. Neste capitulo 
mostrarei os conceitos gerais relacionados a programação funcional, e explicar como 
a linguagem Ruby suporta estes conceitos e nos ajuda a criar códigos mais legíveis, 
com manutenção mais fácil e principalmente mais eficiente. 


5.1 O QUE É PROGRAMAÇÃO FUNCIONAL 


Fundamentalmente, a programação funcional é um paradigma de programação que 
trata a computação como a avaliação das funções matemáticas e a capacidade de evi- 
tar a mutabilidade de estado. O paradigma funcional enfatiza o uso das funções que 
não alteram estado, ao contrário da programação imperativa. O paradigma foi fun- 
damentado no ano de 1930 com o lambda calculus, um sistema formal desenvolvido 
para investigar a definição de funções, aplicação delas e também a recursão. 
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5.2 FUNÇÕES PURAS 


A principal diferença entre as funções matemáticas e as funções criadas nas lingua- 
gens imperativas, é que na segunda, funções podem causar efeitos colaterais, alte- 
rando o valor já calculado anteriormente. Na prática isso que dizer que ao criarmos 
um função e a invocarmos, o seu resultado vai depender do estado atual no momento 
em que ela for executada. No paradigma funcional as funções dependem apenas dos 
argumentos que foram recebidos em sua chamada, sendo assim, invocar a função N 
vezes resulta sempre no mesmo valor, por este motivo chamamos estas funções de 
puras. 

Eliminar estes efeitos colaterais facilita o entendimento do comportamento do 
programa e também evita preocupações quando temos código sendo executado pa- 
ralelamente, pois nosso código naturalmente se tornou Thread Safe. 

A linguagem Ruby contempla várias características das funções puras. Vamos 
tomar como exemplo a String, que possui vários funções (métodos) puras: 


nome = "Lucas" 
puts nome.upcase # => LUCAS 
puts nome # => Lucas 


No código acima criamos uma variável nome que possui o valor “Lucas”. A cha- 
mada do método upcase ao invés de alterar a variável para guardar o valor “LU- 
CAS” retorna uma nova String com o valor em caixa alta. Você pode confirmar 
este comportamento na linha criada após a chamada do método upcase que im- 
prime o valor da variável nome, que é exatamente o mesmo valor que definimos na 
declaração da variável. 

O método upcase é uma função pura, porque não importa quantas vezes seja 
invocado, retornará sempre o mesmo valor e também não causa efeitos colaterais. 


O símbolo ! 


Ao mesmo tempo que Ruby contempla o paradigma funcional, ela também é 
uma linguagem imperativa, ou seja, possui funções que focam em alterar o estado 
dos dados. Existem vários métodos na API da linguagem que possuem o caractere ! 
após seus nomes. O caractere ! no final do nome do método é uma convenção, que 
significa que o método deve ser usado com moderação, porque pode causar efeitos 
colaterais. Por exemplo o método upcase!: 
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nome = "Lucas" 
puts nome.upcase! # => LUCAS 
puts nome # => LUCAS 


Como você pode notar ao executar este código, o método upcase! não é um 
método funcional puro, porque possui efeitos colaterais que alteram a String den- 
tro da variável nome. Por isso, sempre que utilizar algum método com ! no final, 
tenha cuidado. O lado bom é que se precisarmos definir um método que irá alte- 
rar o estado de um determinado objeto, podemos defini-los com o caractere ! no 
final para que outros desenvolvedores estejam cientes do cuidado ao utilizar aquele 
método. 


5.3 COMANDOS QUE RETORNAM VALORES 


Literais, chamada de métodos, variáveis, estruturas de controle, todos estes coman- 
dos são avaliados como expressões pelo interpretador Ruby. Vamos tomar como 
exemplo o caso onde desejamos atribuir um determinado valor a uma variável se 
uma condição for verdadeira e outro valor caso a condição seja falsa. Podemos criar 
esse código em Ruby da seguinte maneira: 


valor = nil 


numero = "dois" 
if numero == "um" then valor = 1 
elsif numero == "dois" then valor = 2 


else valor = 3 
end 


p valor # => 2 


Porém o código acima pode ficar mais legível se aproveitarmos o poder da lin- 
guagem Ruby de avaliar tudo como uma expressão: 


numero = "dois" 
valor = if numero == "um" then 1 
elsif numero == "dois" then 2 
else 3 
end 


p valor # => 2 
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Podemos nos aproveitar desta habilidade da linguagem de avaliar tudo como 
uma expressão no momento que precisamos declarar várias variáveis com o mesmo 
valor: 


pa, b, c #=> 000 


Até mesmo quando utilizamos um for, o seu resultado é uma expressão. Se 
percorrermos um Array com três elementos usando um for e multiplicarmos 
cada item por 2, por exemplo, podemos atribuir seu resultado a uma variável: 


numeros = [1, 2, 3, 4] 
novos_numeros = for n in numeros 
n * 2 


end 
p novos_numeros # => [1, 2, 3, 4] 


O método for que utilizamos retorna um Array com os mesmos valores in- 
seridos no Array antigo. Esse é o comportamento do for e também do método 
each que veremos em breve, retornar sempre o Array original. Para criar um novo 
Array com os valores retornados por cada iteração é necessário utilizar o método 
map que também será visto em breve. 


Métodos sem return 


Todos os métodos Ruby retornam sempre o resultado da última expressão de- 
clarada, por esse motivo, você não precisa explicitamente adicionar o return no 
final de cada método: 


def boas_vindas (nome) 
"Bem vindo: #{nome}" 
end 


p boas vindas("Lucas") # => "Bem vindo: Lucas" 


Quando invocado o método boas vindas retornará a String interpolada 
com o valor do argumento nome que foi passado. 
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5.4 FUNÇÕES DE ALTA ORDEM HIGHER-ORDER FUNCTIONS 


Funções ou métodos são high-order quando tem a capacidade de receber outras fun- 
ções como argumentos ou retornar funções como resultado. Em Ruby isto é feito 
usando blocos, lambdas e procs. 


Blocos, lambdas e procs são um dos aspectos mais poderoso da linguagem Ruby, 
e também um dos que causam mais confusões para serem entendidos, isso porque 
Ruby possui quatro maneiras de lidar com high-order functions. 


Blocos 


Este é o método mais comum trabalhar com funções high-order em Ruby. Os 
blocos são muito utilizados e comuns quando percorremos coleções: 


numeros = [1, 2, 3, 4] 


numeros.each { |numero| p numero + 


E => 1 
# => 2 
# => 3 
# => 4 


Mas o que está acontecendo nesse código afinal? 

A primeira e mais importante parte que devemos entender, está na chamada ao 
método each que fizemos na variável numeros. Ao invocarmos o método, estamos 
passando uma função ou bloco de código como argumento. Internamente o método 
each iterao Array, executa o bloco de código recebido como argumento passando 
o valor da iteração (neste caso a variável numero). O bloco de código que recebe a 
variável numero está imprimindo a mesma no console utilizando o método p. 

Existem outros métodos da classe Array que recebem um bloco de código como 
argumento e o executam a cada iteração. Por exemplo, o método collect: 


numeros = [1, 2, 3, 4] 
numeros_ao_quadrado = numeros.collect { |numero| numero ** 2 } 
p numeros_ao_quadrado # => [1, 4, 9, 16] 


O comportamento do método collect é similar ao método each, cada item 
do Array onde o método foi invocado é passado como argumento para o bloco 
recebido na chamada. 
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Ao invocar o método collect obtemos um novo Array com todos 
os números ao quadrado. Desta maneira, quando imprimimos a variável 
numeros ao quadrado o resultado é [1, 4, 9, 16]. 

Tanto o método each quanto o método collect fazem parte da API pública da 
classe Array. Existem vários outros método bastante úteis na API dos arrays, você 
deve sempre consultá-la para não reimplementar comportamentos que já existem. 
Lembre-se que um dos principais atrativos da linguagem Ruby é a sua legibilidade, 
conhecer bem a API da linguagem é um dos passos mais importantes para conseguir 


tal vantagem. 


5.5 CRIE SEU PRÓPRIO CÓDIGO QUE USA UM BLOCO DE CÓ- 
DIGO 


Mas e se quisermos criar nosso próprio método que recebe um bloco de código? 
Como podemos implementá-lo? 

Vamos criar um método que filtra os livros por uma determinada categoria, itera 
cada um destes livros e executa um bloco de código que será passado para este mé- 
todo. Nosso primeiro passo será criar o método dentro da classe Biblioteca: 


class Biblioteca 
def initialize 
@livros = {} # Inicializa com um hash 
end 


def adiciona(livro) 
@livros[livro.categoria] ||= 0 
@livros[livro.categoria] << livro 
end 


def livros 
@livros.values.flatten 
end 


def livros_por_categoria(categoria) 
@livros [categoria] 
end 
end 


O filtro por categoria é bem simples, o argumento esperado será o Symbol 
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identificador do tipo dos livros que desejamos. Agora precisamos iterar estes livros 
e executar um bloco de código passado como argumento na chamada do método 


livros por categoria: 


class Biblioteca 
def initialize 
@livros = {} # Inicializa com um hash 
end 


def adiciona(livro) 
@livros[livro.categoria] ||= 0 
@livros[livro.categoria] << livro 
end 


def livros 
@livros.values.flaten 
end 


def livros_por_categoria(categoria) 
@livros[categoria].each do |livro| 
yield livro 
end 
end 
end 


Quando filtramos os livros por categoria: @livros [categoria], recebemos 
como retorno um Array, e agora podemos percorrê-lo utilizando o método each 
que recebe um bloco de código, e o executa N (número de livros que contém dentro 
do Array) vezes, sendo que a cada iteração o bloco é executado recebendo o item 
(no caso um objeto do tipo Livro) na variável livro que declaramos entre os 
caracteres ||. 

Outra novidade é que diferentemente dos atributos, blocos não precisam ser de- 
clarados na assinatura de método, para executá-los basta chamar o método yield 
passando os argumentos que serão recebidos pelo bloco declarado na chamada do 
método livros por categoria. O método yield executará automaticamente 
o bloco que for passado na chamada do método. 

Agora basta invocar o método passando a categoria pela qual desejamos efe- 
tuar o filtro e também o bloco de código que será executado para cada um dos objetos 
do tipo Livro encontrados no Array (adicione também o attr reader para o 


atributo autor na classe Livro): 
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biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 
247, 69.9, :testes 
web_design_responsivo = Livro.new "Tarcio Zemel", "452565", 


189, 69.9, :web_design 


biblioteca.adiciona teste_e_design 
biblioteca.adiciona web_design_responsivo 


biblioteca.livros_por_categoria :testes do |livro 
p livro.autor 
end 


=> "Mauricio Aniche" 


Quando executamos o método livros por categoria passamos um 
Symbol :testes que representa a categoria de livros que desejamos filtrar e tam- 
bém um bloco de código que recebe na variável livro declarada dentro dos carac- 
teres | | cada um dos objetos existentes para a categoria filtrada. 

A grande vantagem desta abordagem é que possuímos uma maneira flexível de 
interagir com o método, ou seja, o bloco passada na chamada do método pode de- 
cidir qual comportamento executar com cada um dos objetos recebidos. 

Você sempre deve pensar em blocos como uma maneira de flexibilizar os méto- 
dos da sua API. Nós podemos, por exemplo, ao invés de imprimir o nome do autor 
no console, imprimi-lo em uma impressora: 


biblioteca = Biblioteca.new 


impressora = Impressora.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 
247, 69.9, :testes 
web_design_responsivo = Livro.new "Tarcio Zemel", "452565", 


189, 69.9, :web_design 


biblioteca.adiciona teste_e_design 
biblioteca.adiciona web_design_responsivo 


biblioteca.livros_por_categoria :testes do |livro 


impressora.imprime livro.autor 
end 
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A classe Impressora poderia ser uma implementação que envia dados para 
uma impressora conectada via USB ou mesmo via rede sem fio. O que quero lhe 
mostrar é que trocando apenas uma linha, mudamos o comportamento e a maneira 
que interagimos com o método livros por categoria. Ele é um método fle- 
xível, que recebe um bloco de código onde podemos customizar o comportamento 
que desejamos. 


Evite erros quando um bloco não é passado 


O método livros por categoria espera que um bloco de código seja pas- 
sado como argumento. Porém, se este bloco for utilizado internamente, mas não for 
passado como argumento, ocorrerá um erro informando que este método deveria 
ter sido informado: 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 
247, 69.9, :testes 


biblioteca.adiciona teste_e_design 
biblioteca.livros_por_categoria :testes 
# => LocalJumpError: no block given (yield) 


Podemos resolver este problema de forma defensiva, evitando um erro caso ne- 
nhum bloco de código seja informado utilizando o método block given? que 
está disponível em todos os objetos criados em Ruby: 


class Biblioteca 
def livros por categoria(categoria) 
QGlivros [categoria] .each do |livro| 
yield livro if block given? 
end 
end 
end 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 
247, 69.9, :testes 
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biblioteca.adiciona teste e design 
biblioteca.livros por categoria :testes 


O método block given? verifica se algum bloco foi passado como argumento 
na chamada do método e retorna um valor booleano. Em nosso exemplo, caso al- 
gum bloco seja passado, o executamos, caso contrário o método yield não será 
invocado. 

Está técnica defensiva é muito útil quando criamos frameworks que serão uti- 
lizados por várias bases de código Ruby e onde não temos muito controle sobre os 
clientes destas APIs que estamos criando. 


5.6 EXPLORANDO A API ENUMERABLE 


As classes Array e Hash que vimos até o momento, possuem métodos comuns 
entre elas, que são disponibilizados por um módulo (veremos módulos em breve) 





chamado Enumerable. Estes métodos permitem executar tarefas com coleções, 
com apenas uma ou duas linhas de código Ruby. 


Método inject 


Vamos criar uma classe chamada Relatorio dentro de um novo arquivo cha- 
mado relatorio.rb que ficará dentro da pasta 1ib do projeto. Esta classe terá 
uma série de métodos para fornecer dados importantes referentes aos livros que te- 
mos cadastrados. Para começar, vamos criar um método que retorna a soma total 
dos preços de todos os livros que temos cadastrados na biblioteca: 


class Relatorio 
def initialize(biblioteca) 
Obiblioteca = biblioteca 
end 


def total 
soma = 0.0 


@biblioteca.livros.each do |livro 
soma += livro.valor 


end 


soma 
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end 
end 


Antes de criar os testes para esta nova classe, não se esqueça de adicionar o 


require dentro do arquivo lob/loja virtual: 





require File.expand_path('lib/livro') 
require File.expand_path('lib/biblioteca') 
require File.expand_path('lib/relatorio') 


Agora basta adicionar alguns livros dentro da biblioteca e após isso criar um 
objeto do tipo Relatorio passando como dependência o objeto Biblioteca e 
invocar o método total que acabamos de criar: 


biblioteca = Biblioteca.new 


teste e design = Livro.new "Mauricio Aniche", "123454", 
247, 69.9, :testes 
web_design_responsivo = Livro.new "Tarcio Zemel", "452565", 


189, 69.9, :web_design 


biblioteca.adiciona teste_e_design 
biblioteca.adiciona web_design_responsivo 


relatorio = Relatorio.new biblioteca 
p relatorio.total # => 139.8 


Podemos melhorar esse código, utilizando e conhecendo um pouco mais da API 
Enumerable, que possui um método chamado inject, que simplifica muito o có- 
digo: 


class Relatorio 
def initialize(biblioteca) 
Obiblioteca = biblioteca 
end 


def total 
@biblioteca.livros.inject(0) { |tot, livro| tot += livro.valor + 
end 
end 
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O método inject recebe como primeiro argumento um valor que será atri- 
buto a variável acumuladora, geralmente inicializado em o, o segundo argumento 
é um bloco que recebe outros dois argumentos, o primeiro é a variável acumula- 
dora, que foi inicializada anteriormente, no exemplo, o. Já o segundo argumento 
se refere a cada um dos livros existentes no Array de livros retornados pelo objeto 
Biblioteca. À cada iteração somamos o valor do objeto Livro à variável acumu- 
ladora que chamamos de total, no final o valor desta variável é retornado como 
resultado do método. 


Método map 


A classe Relatorio precisa agora de um método que retorne o título de todos 
os livros que possuímos no objeto Biblioteca. Porém a classe Livro não possui 
um atributo titulo, sendo assim, nosso primeiro passo será adicionar este atributo 
e logicamente um método acessor para visualizar o título do livro, já que o atributo 
será privado: 


# coding: utf-8 
class Livro 
attr_accessor :valor 
attr_reader :categoria, :autor, :titulo 


def initialize(titulo, autor, isbn = "1", numero_de_paginas, 
valor, categoria) 
@titulo = titulo 
@autor = autor 
@isbn = isbn 
@numero_de_paginas = numero_de_paginas 
@categoria = categoria 
@valor = valor 


end 
def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: #{@numero_de_paginas}, 
Categoria: #{@categoria}" 
end 


def eql?(outro_livro) 
@isbn == outro_livro.isbn 
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end 


def hash 
Gisbn.hash 
end 
end 


O próximo passo é criar o método titulos na classe Relatorio que será 


responsável por retornar o título dos livros presentes na biblioteca: 


class Relatorio 
def initialize(biblioteca) 
Obiblioteca = biblioteca 
end 


def total 
@biblioteca.livros.inject(0) { |tot, livro| tot += livro.valor } 


end 


def titulos 
titulos = [] 


@biblioteca.livros.each do |livro 
titulos << livro.titulo 


end 
titulos 
end 
end 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


biblioteca.adiciona Livro.new "Design Responsivo", "Tarcio Zemel", 
"45256", 189, 69.9, :web_design 


relatorio = Relatorio.new biblioteca 
p relatorio.titulos # => ["TDD", "Design Responsivo"] 


O método titulos possui o mesmo problema do método total em sua pri- 
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meira versão: Muito código para uma tarefa extremamente simples. Novamente se 
conhecermos a API Enumerable, podemos simplificar o código utilizando um mé- 
todo chamado map: 


def titulos 
@biblioteca.livros.map { |livro| livro.titulo 5 
end 


O método map itera sobre um Array, e para cada elemento (neste caso um 
objeto Livro) executa um bloco de código passado como argumento. O resultado 
da execução deste bloco, é guardado dentro de um Array acumulador, que é re- 
tornado no final da iteração de todos os livros. No código acima, o resultado da 
execução do bloco é o titulo do Livro, como possuímos dois objetos Livro 
dentro da biblioteca, o retorno do método map será um Array contendo o títulos 
dos dois livros. 

O método map possui o mesmo comportamento do método collect que foi 
visto anteriormente. Essencialmente o método collect foi criado para satisfazer 
programadores Smalltalk que possui um método similar. Já o método map possui o 
mesmo nome de métodos similares de linguagens como Scala. 


Método map com notação simplificada 


Existe uma maneira mais simples de passar um bloco na chamada ao método 


map: 


class Relatorio 
def initialize(biblioteca) 
Obiblioteca = biblioteca 
end 


def total 
Obiblioteca.livros.inject(0) {|tot, livro| tot += livro.valor} 
end 


def titulos 
@biblioteca.livros.map &:titulo 
end 


end 


A expressão &:titulo cria um bloco como este: { |livro| 
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livro.titulo }. O character & invoca um método to proc no objeto, e 
passa este bloco para o método map. 


Simplificando uso do método inject 


Aprendemos que é possível simplificar o uso do método map utilizando a nota- 
ção s:method. O método inject possui uma simplificação quando, por exemplo, 
desejamos que os valores de todos os livros sejam somados. O código atual do mé- 
todo total é assim: 


class Relatorio 
def total 
@biblioteca.livros.inject(0) {|tot, livro| tot += livro.valor} 
end 
end 


Podemos utilizar o método map para obter um novo Array apenas com os 
valores de todos os livros existentes: 


class Relatorio 
def total 
Obiblioteca.livros 
.map(&:valor) .inject(0) {|tot, valor| tot += valor} 
end 
end 


O método inject possui uma variação, onde é possível passar um Symbol 
e não um bloco como argumento em sua chamada. Esta variação entende que o 
símbolo passado como argumento refere-se ao método que será chamado na variável 


acumuladora, no código acima, seria o método +: 


class Relatorio 
def total 
@biblioteca.livros.map(&:valor) .inject(:+) 
end 
end 


O método + então será invocado automaticamente na variável acumuladora para 
cada uma das iterações feita, recebendo como argumento a variável valor que re- 
presenta o item iterado. Outro detalhe é que não foi necessário inicializar a variável 
acumuladora, automaticamente ela é criada com o valor o. 
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5.7 PARA SABER MAIS: OUTRAS MANEIRAS DE CRIAR BLO- 
cos 


Procs 


Na seção anterior executamos blocos de código através do método yield. Uma se- 
gunda maneira é recebermos o bloco de código como um argumento do tipo Proc. 
Vamos ver o código e depois discutiremos as diferenças: 


class Biblioteca 
def initialize 
@livros = {} # Inicializa com um hash 


end 


def adiciona(livro) 
@livros[livro.categoria] |l= 0 
@livros[livro.categoria] << livro 
end 


def livros 
@livros.values.flaten 
end 


def livros por categoria(categoria, &bloco) 
@livros[categoria].each do |livro| 
bloco.call livro 
end 
end 
end 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


biblioteca.adiciona Livro.new "Design Responsivo", "Tarcio Zemel", 
"45256", 189, 69.9, :web_design 


biblioteca.livros por categoria :testes do |livro| 


p livro.autor 
end 
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=> "Mauricio Aniche" 


O código é bastante parecido, porém possui duas importantes diferenças. 
A primeira é que passamos um argumento chamado «bloco para o método 
livros por categoria. O caractere « indica que estamos recebendo uma ins- 
tância de Proc que na realidade é o bloco de código que vamos executar. A se- 
gunda diferença é que não invoca-se o bloco de código chamando o método yield, 
agora invocamos o método cal1 no argumento recebido na declaração do método 
(bloco). 

O que ainda não fica muito claro é por que usaríamos uma Proc ao invés de um 
simples yield? 

As vezes precisamos executar o mesmo bloco de código várias vezes, um objeto 
do tipo Proc guarda um bloco de código, e pode ser passado como parâmetro várias 
vezes para efetuar a chamada de um mesmo método, por exemplo: 


class Biblioteca 
def initialize 
@livros = {} # Inicializa com um hash 
end 


def adiciona(livro) 
@livros[livro.categoria] ||= 0 
@livros[livro.categoria] << livro 
end 


def livros 
@livros.values.flatten 
end 


def livros_por_categoria(categoria) 
@livros[categoria].each do |livro| 
yield livro if block_given? 
end 
end 
end 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
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247, 69.9, :testes 


imprime livro no console = Proc.new do |livro| 
p livro.autor 
end 


biblioteca.livros por categoria :testes, imprime livro no console 
# => ArgumentError: wrong number of arguments (2 for 1) 


O que fizemos foi definir um objeto Proc na variável 
imprime livro no console que guarda o bloco de código que havíamos 
criado anteriormente, com isso podemos passá-lo para qualquer método que recebe 
um bloco como argumento. 

O único problema é que o código acima não funciona, e a mensagem de erro pa- 
rece bem estranha. Ela nos diz que estamos invocando um método que deve receber 
um argumento passando dois. Isso que dizer que o bloco não conta como argumento 
do método? 

Exatamente. O método livros por categoria recebe apenas um argu- 
mento explícito chamado categoria o outro é um bloco, que como na antiga 
implementação, não precisa necessariamente ser passado. Mas isso ainda não ex- 
plica o erro retornado, afinal, tudo bem que o bloco pode ser ou não passado, mas 
no meu exemplo eu desejo passá-lo. 

O que acontece é que a variável imprime livro no console que está aguar- 
dando a Proc que foi criada é um objeto, ou seja, quando invocamos o método 
livros por categoria passando o objeto imprime livro no console 
como argumento, é como se estivéssemos passando qualquer outro argumento na 
chamada. Porém, sabemos que o método recebe apenas um argumento, obrigatori- 
amente. 

O que precisamos fazer é transformar o objeto do tipo Proc 
imprime livro no console em um bloco convencional e passar este bloco 
como argumento na chamada do método. Essa transformação é feita utilizando o 
caractere &: 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 
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imprime livro no console = Proc.new do |livro 
p livro.autor 
end 


# transforma objeto proc em um bloco convencional 
biblioteca.livros por categoria :testes, &imprime livro no console 


Ao adicionar o caractere & antes da variável que guarda o bloco que desejamos 
passar como argumento para o método livros por categoria, ele será auto- 
maticamente ‘convertido’ para um bloco convencional novamente. 

Desta maneira, o método livros por categoria continua recebendo e exe- 
cutando um bloco através da chamada ao método yield. A vantagem é que o bloco 
em um objeto do tipo Proc pode ser reutilizado em outras partes do código. 


Recebendo dois blocos como argumento 


Caso seja necessário em algum momento, receber dois blocos como argumento 
de um método, a utilização do yield torna-se obsoleta, já que não seria possível 
descobrir qual dos dois blocos deveria ser executado. 


Neste caso, a solução é receber explicitamente os dois blocos como argumentos 
do método. Porém, como objetos do tipo Proc e não blocos convencionais: 


class Biblioteca 
def livros por categoria(categoria, bloco com p, bloco com puts) 
QGlivros [categoria] .each do |livro| 
# Sem o &, transformamos o bloco em um objeto novamente 
bloco com p.call livro 
bloco com puts.call livro 
end 
end 
end 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


imprime livro no console = Proc.new do |livro| 


p livro.autor 
end 
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imprime livro no console com puts = Proc.new do |livro 
puts livro.autor 
end 


biblioteca.livros por categoria :testes, 
imprime livro no console, 
imprime livro no console com puts 


Como recebemos dois objetos do tipo Proc, não é possível invocá-los através 
do método yield, como foi dito. Devemos trata-los como Procs, por isso, para 
executá-los é necessário invocar o método cal1 em cada um deles. 

Se o bloco passado como argumento receber mais de um argumento, basta invo- 
car o método call passando-os separados por ,, assim como seria feito na chamada 


utilizando yield. 


Lambdas 


Existem outra maneira de guardar um bloco de código em uma variável e passá- 
lo como argumento na chamada de um método, são os lambdas, que são conhecidos 


também como funções anônimas: 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


imprime livro no console = lambda do |livro| 
p livro.autor 
end 


biblioteca. livros por categoria :testes, &imprime livro no console 
=> "Mauricio Aniche" 


Os lambdas se parecem muito com procs, entretanto, existem duas diferenças. 
A primeira é que quando utilizamos lambdas, ao contrário das procs, existe uma 


checagem da quantidade de parâmetros passados: 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
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247, :testes 


imprime_livro_no_console = lambda do 
p 'executou lambda' 
end 


imprime livro no console proc = Proc.new do 
p 'executou proc' 
end 


biblioteca.livros por categoria :testes, &imprime livro no console proc 
=> NameError: undefined local variable or method “livro! 


biblioteca.livros por categoria :testes, &imprime livro no console 
=> ArgumentError: wrong number of arguments (0 for 1) 


Quando invocamos o método livros por categoria passando um objeto 
do tipo Proc, na invocação do bloco nenhum argumento é esperado, mas mesmo 
assim o p colocado é executado. Quando o bloco passado é do tipo Lambda, acon- 





teceumerro: ArgumentError informando que o bloco deveria esperar pelo menos 
1 argumento, entretanto nenhum foi declarado. 

A segunda diferença acontece quando utilizamos return dentro de um 
lambda. Quando declaramos um return dentro de um lambda, o método que 
invocou o bloco receberá o retorno deste bloco e continuará com sua execução nor- 
malmente. Se utilizarmos um return dentro de uma proc o método que invocou o 
bloco será interrompido e seu retorno será o valor retornado na execução da mesma. 


Vamos ver um pequeno exemplo para deixar as coisas mais claras: 


def proc com return 
Proc.new { return "retornando algo de uma proc" }.call 
"Proc finalizada" 

end 


def lambda com return 
lambda { return "retornando algo de um lambda" }.call 
"Lambda finalizado" 

end 


puts proc com return 
puts lambda com return 
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# => retornando algo de uma proc 
# => Lambda finalizado 


Procs são como procedures, apenas parte de código que serão executados como 
parte do comportamento de um método. Lambdas se parecem mais com métodos, 
onde existe checagem do número parâmetros e não sobrescrevem o return defi- 
nido no método que os invocaram. Existe apenas um caso onde é necessário obri- 
gatoriamente invocar um método passando uma instância de lambda e não um 
instância de proc: 


def metodo que recebe um bloco(bloco) 
bloco.call 
"retornando algo do método" 

end 


p metodo que recebe um bloco(Proc.new { return "Retorno da Proc" }) 
p metodo que recebe um bloco(lambda { return "Retorno do Lambda" 3) 


# => LocalJumpError: unexpected return 
# => retornando algo do método 


O interpretador Ruby não permite que um argumento passado para um método 
contenha um return. Em nosso exemplo a Proc possui um return explícito, por 





este motivo, acontece o erro: LocalJumpError. Como lambdas se comportam 
como métodos, eles podem conter um return explícito. 


5.8 PARA SABER MAIS: CURRYING 


Currying é uma técnica muito utilizada em linguagens funcionais, que consiste em 
transformar uma função que recebe múltiplos argumentos em uma sequência de 
funções que recebem um único argumento. A definição parece um pouco compli- 
cado, mas pode ser simplificada com um pouco de código, vamos ver: 


executa comando = lambda ( |conexao, comando| conexao.executa comando 
executa comando.call Conexao.new, Update.new 


O código acima simula a execução de um comando qualquer (no exemplo um 
Update) em um banco de dados através da chamada de um método executa em 
um objeto do tipo conexao. Criamos um lambda que recebe dois argumentos: a 
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conexão com o banco e o comando que desejamos executar, após isso executamos 
este lambda passando os argumentos necessários. 

Em determinado momento pode ser útil executar o lambda executa comando 
passando um comando Insert, como demonstrado no código abaixo: 


executa comando = lambda { |conexao, comando| conexao.executa comando 
executa comando.call Conexao.new, Update.new 
executa comando.call Conexao.new, Insert.new 


Repare que sempre que vamos executar o lambda executa comando precisa- 
mos passar a conexao, o único parâmetro que mudou foio comando. Para melhorar 
este código, podemos utilizar a técnica de currying: 


executa comando = lambda { |conexao, comando| conexao.executa comando 
. curry 
executa comando com conexao = executa comando.call Conexao.new 


executa comando com conexao.call Update.new 
executa comando com conexao.call Insert.new 


Quando invocamos o método curry no objeto Lambda, nós o particionamos 
em duas funções, pois o lambda recebe dois argumentos. A primeira função que 
receberá o objeto Conexao, quando invocamos esta primeira função, ela retorna 
a segunda função, que neste exemplo, receberá o argumento referente ao comando 
que desejamos executar: Insert ou Update. Ao invocar esta segunda função, o 
conteúdo definido inicialmente no objeto lambda criado, será finalmente executa e 
a operação será efetuada utilizando a conexao e o comando que foram passados. 

A grande vantagem do uso de currying é quando vamos executar o mesmo bloco 
de código, seja ele um lambda ou uma proc, e alguns parâmetros são sempre os mes- 
mos. Utilizando esta técnica podemos fixar alguns argumentos com o mesmo valor, 
independente da quantidade de vezes que o bloco for executado. Também é muito 
útil quando queremos deixar o código mais claro e conciso, por exemplo: 


multiplicador = lambda { |x, yl x * y} 
p multiplicador.call 2, 13 
# => 26 


O código acima é bem simples, ele cria um lambda que multiplica dois argumen- 
tos passados x e y e retorna o resultado. No exemplo, foi calculado o dobro do valor 
13. Agora desejamos calcular o dobro do número 43, fazemos isto com uma simples 
chamada ao multiplicador: 
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multiplicador = lambda { Ix, yl x * y} 


p multiplicador.call 2, 13 
p multiplicador.call 2, 43 


# => 26 
# => 86 


Utilizando currying podemos deixar o código um pouco mais legível: 


multiplicador = lambda { |x, yl x * y }.curry 
dobro = multiplicador.call 2 


p dobro.call 13 
p dobro.call 43 


# => 26 
# => 86 


Particionamos o lambda em duas funções, a primeira recebe o argumento x, e ao 
invocar esta primeira função passando como argumento o valor 2, a chamamos de 
dobro, afinal não importa qual seja o valor passado na chamada da segunda função, 
o valor de x está fixo em 2. 


5.9 PARA SABER MAIS: CLOSURE 


Quando criamos um bloco de código (lambda, proc ou bloco convencional) ele pos- 
sui acesso às variáveis visíveis do escopo onde foram criados, e qualquer alteração 
nestas variáveis serão refletidas no escopo original, ou seja, os blocos possuem uma 
espécie de link com as variáveis definidas no escopo de origem. Por exemplo: 


soma = O 


[1, 3, 5, 6, 9].each do |numero 
soma += numero 
end 


p soma É => 24 


Repare que o bloco de código que definimos e passamos na chamada ao método 
each possui acesso a variável soma que foi definida no escopo onde o bloco foi 
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criado. Esta capacidade de fazer bind com as variáveis que foram definidas no escopo 
onde o bloco foi criado é conhecido com closure. 
Este comportamento pode ser confirmado ao executarmos o seguinte exemplo: 


def imprime numero 
numero = 134 
yield 

end 


def chama metodo imprime numero 
numero = 42 
imprime numero do 
puts "0 número aqui é: #{numero}" 
end 
end 


chama metodo imprime numero # => 42 


O número impresso é 42 porque no escopo onde o bloco foi criado a variável 
numero possui o valor 42. No contexto onde o bloco foi invocado existe um outra 
variável numero com o valor 134, porém esta segunda variável foi definida no 


contexto do método imprime numero e não é visível ao bloco. 


5.10 PRÓXIMOS PASSOS 


Neste capítulo aprendemos conceitos importantes de um outro paradigma de pro- 
gramação: o funcional. Existem vários conceitos deste paradigma espalhados pelos 
mais importantes códigos escritos em Ruby mundo afora. Portanto, posso afirmar 
que você verá e utilizará este recursos, principalmente os blocos, que na minha opi- 
nião são os mais importantes e que podem contribuir para que você crie códigos 
elegantes e legíveis. 

Também aprendemos a utilizar um pouco da API Enumerable que possui vários 
método úteis para trabalharmos com coleções em Ruby. Conhecer esta API é um 
excelente caminho para criar códigos mais legíveis e funcionais quando lidamos com 
coleções, estude-a e tenha o link da API: http://ruby-doc.org/core-1.9.3/Enumerable. 
html sempre aberto quando estiver trabalhando ou estudando. 

No próximo capítulo veremos um pouco da API de File do Ruby, ela será muito 
importante para criarmos um espécie de framework que salva e recupera dados os 
livros criados utilizando arquivos em disco. 
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Explorando API File 


Agora que conhecemos e aprendemos a utilizar blocos, temos todo o conhecimento 
necessário para partirmos pra API do Ruby que lida com arquivos e diretórios. Uti- 
lizaremos essa API para salvarmos os objetos que representam Livro em nosso 
sistema. Veremos também como trabalhar com serialização e deserialização de ob- 
jetos, que será a maneira que salvaremos nossos objetos em disco. 


6.1 UM POUCO DA CLASSE FILE 


A classe File da API do Ruby é uma abstração de objetos que são criados para 
representar um arquivo. Podemos, por exemplo, descobrir qual o tamanho, em bytes, 
de um arquivo salvo em disco: 


arquivo temporario = File.new("/tmp/arquivo") 
p arquivo temporario.size # => 564 


A API de arquivos possui uma grande variedade de métodos que utilizam blocos 
como forma de interação. Podemos criar um arquivo e incluir dados dentro dele com 
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apenas uma linha de código: 


File.open("/tmp/arquivo", "w") do |arquivo_temporario| 
arquivo_temporario.puts "primeira linha do meu arquivo" 
end 





ESCREVENDO COM O MÉTODO WRITE 


Podemos escrever dentro de um arquivo utilizando o método write 
ao invés do método puts. A principal diferença é que o método puts 
adiciona uma quebra de linha \n no final da String que foi incluída 
no arquivo, enquanto o método write não o faz. 











Dado que temos o arquivo texto /tmp/arquivo salvo, podemos abri-lo e im- 
primir cada uma de suas linhas: 


arquivo temporario = File.open "/tmp/arquivo", "r" 


arquivo temporario.each do |linhal 
p linha # => "primeira linha do meu arquivo\n" 
end 





MODOS DE ABRIR UM FILE 


O segundo parâmetro passado quando invocamos o método open, é 
o modo que desejamos abrir o arquivo. As maneiras mais comuns são: 


e x - abre o arquivo somente para leitura 


e w - abre o arquivo somente para escrita (sobrescreve todo o con- 
teúdo do arquivo se o mesmo existir) 


e w+ - abre o arquivo tanto para leitura quanto para escrita (sobres- 
creve todo o conteúdo do arquivo se o mesmo existir) 


e a - abre o arquivo somente para escrita (começa a escrita no final 
da última linha existente se o arquivo já existir) 
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A API File é muito rica em detalhes e por isso poderíamos gastar algumas 
páginas explicando todos os métodos e suas utilidades. Porém vamos fazer algo mais 
útil, vamos começar a salvar os objetos da classe Livro que estamos criando e salvá- 
los em arquivos para posteriormente poder ler estes dados e recuperar os objetos. 


Porém é necessário antes criarmos a classe que fará este trabalho. 


6.2 SERIALIZACAO DE OBJETOS 


Serialização nada mais é do que o processo de salvar um objeto utilizando um sis- 
tema de armazenamento qualquer, como por exemplo, um arquivo, ou até mesmo 
transmiti-lo pela rede. Estes dados são salvos em formato binária ou formato texto, 
como XML, JSON, YML, etc e podem ser utilizados posteriormente para recriar um 
objeto em memória com o mesmo estado em que ele foi armazenado. 

Ruby possui dois mecanismos de serialização de objetos nativos da própria lin- 
guagem. Um deles serializa os objetos em um formato que é fácil de ser lido por um 
ser humano, enquanto o outro serializa em um formato binário. 

Vamos utilizar e explorar o formato humano de serialização que é representando 
pelo formato YAML (http://ruby-doc.org/core/classes/YAML.html) . Qualquer ob- 
jeto pode ser serializado para o formato YAML sem o mínimo esforço, gastando ape- 
nas algumas linhas de código: 


require 'yaml' 


teste e design = Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


objeto_serializado = YAML.dump teste_e_design 
p objeto_serializado 


A saída desse código será algo como: 


"___ Iruby/object:Livro \nautor: Mauricio Aniche\nisbn: 247\n 


numero_de_paginas: \"123454\"\n 
titulo: TDD\nvalor: :testes\n" 


A String que foi impressa, e que parece um pouca estranha, é a representa- 
ção do objeto teste e design no formato texto YAML, que pode ser facilmente 
adicionado dentro de um arquivo. 

Podemos deserializar o YAML que foi criado, e criar uma outra instância de 
Livro, com as mesmas informações e estado do objeto teste e design: 


93 


6.3. Salvando objetos em arquivos Casa do Código 





outro teste e design = YAML.load objeto serializado 
p outro teste e design # => Autor: Mauricio Aniche, Isbn: 123454, 
Páginas: 247, Categoria: testes 


6.3 SALVANDO OBJETOS EM ARQUIVOS 


Nos capítulos anteriores guardamos os objetos do tipo Livro dentro deum Hash, 
separando-os por categoria. Porém, agora vamos salvá-los também em arquivos, 
a nossa estratégia será criar um arquivo com todos os objetos do tipo Livro que 
forem criados e adicionados na biblioteca. 

O ideal é deixar a lógica que lida com a API File separada da lógica exis- 
tente na classe Biblioteca, por isso vamos criar uma nova classe chamada 
BancoDeArquivos dentro do arquivo lib/banco de arquivos.rb, já defi- 
nindo o método salva: 


require 'yaml' 


class BancoDeArquivos 
def salva(livro) 

File.open("livros.yml", "a") do larquivo!| 
arquivo.puts YAML.dump(livro) 
arquivo.puts "" 

end 
end 


end 


Para testar este codigo, precisamos fazer 0 require deste novo arquivo, 
adicionando-o dentro do arquivo lib/loja virtual: 





require File.expand_path('lib/livro') 

require File.expand_path('lib/biblioteca') 
require File.expand_path('lib/relatorio') 

require File.expand_path('lib/banco_de_arquivos') 


E agora sim podemos testar o comportamento implementado no método salva: 


teste e design = Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 


BancoDeArquivos.new.salva teste e design 
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Abrimos o arquivo livros .yaml em modo de escrita, respeitando o conteúdo 
já existente e inserindo novos conteúdo no final do arquivo. É importante ressaltar 
que separamos os objetos serializados através de duas linhas. O conteúdo do arquivo 
é similar ao conteúdo abaixo: 


--- !ruby/object:Livro 
titulo: TDD 

autor: Mauricio Aniche 
isbn: '123454' 
numero_de_paginas: 247 
categoria: :testes 
valor: 69.9 


Na classe Biblioteca guardamos os dados em um Hash e agora vamos 
também invocar o método salva para guardar os dados dentro do arquivo 


livros.yml: 


class Biblioteca 
def initialize 
@livros = {} # Inicializa com um hash 
# Inicializa banco de arquivos 
@banco_de_arquivos = BancoDeArquivos.new 
end 


def adiciona(livro) 
@livros[livro.categoria] |l= [] 
@livros[livro.categoria] << livro 
@banco_de_arquivos.salva livro 
end 


def livros 
@livros.values.flaten 
end 


def livros_por_categoria(categoria) 
@livros[categoria].each do |livro| 
yield livro if block_given? 
end 
end 
end 
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teste e design = Livro.new "TDD", "Mauricio Aniche", "123454", 


247, 69.9, :testes 


biblioteca = Biblioteca.new 


biblioteca.adiciona teste e design 


Podemos deixar o código ainda mais elegante utilizando blocos: 


class Biblioteca 


def initialize 
@livros = {} 
@banco_de_arquivos = BancoDeArquivos.new 
end 
def adiciona(livro) 
salva livro do 
@livros[livro.categoria] ||= [] 
@livros[livro.categoria] << livro 
end 
end 
def livros 
@livros.values.flaten 
end 
def livros_por_categoria(categoria) 
@livros[categoria].each do |livro| 
yield livro if block_given? 
end 
end 
private 
def salva(livro) 
@banco_de_arquivos.salva livro 
yield 
end 


end 
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MÉTODOS PRIVADOS 


O método arquiva pode ser privado, pois não existe necessidade de 
invocá-lo de fora da classe Biblioteca. Para criar métodos privados 
em Ruby, basta invocar o método private e abaixo dele, declarar os 
métodos que deseja que sejam privados. O ideal é deixá-los sempre no 
final do arquivo onde a classe está definida. 








6.4 RECUPERANDO OBJETOS SALVOS 


Vamos alterar um pouco a classe Biblioteca. O primeiro passo será guar- 


dar os objetos em um Array e com isso será necessário alterar o método 


livros por categoria para que ele continue retornando um Array dos livros 


da categoria que é passada como argumento: 


class Biblioteca 


attr reader :livros 


def 


end 


def 


end 


def 


end 


initialize 
@livros = [] # Inicializando com Array 
@banco_de_arquivos = BancoDeArquivos.new 


adiciona(livro) 
salva livro do 

@livros << livro 
end 


livros por. categoria(categoria) 
@livros.select { |livro| livro.categoria == categoria } 


private 


def 


end 


salva(livro) 
@banco_de_arquivos.salva livro 
yield 
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end 


Agora o método livro por categoria utilizao método select existente 
na classe Array. O método livros que consolidava todos os livros existentes 
dentro do Hash foi removido e agora existe apenas um método leitor: livros que 


retorna a variável @livros. 


Vamos agora inicializar o Array @livros com os dados existentes dentro do 
arquivo livros.yml. Para isso será preciso deserializar os objetos existentes dentro 
do arquivo e transformá-los novamente em instâncias de Livro, utilizando a classe 
YAML: 


class BancoDeArquivos 
def salva(livro) 

File.open("livros.yml", "a") do |arquivol 
arquivo.puts YAML.dump(livro) 
arquivo.puts "" 

end 
end 


def carrega 
$/ = "\n\n" 
File.open("livros.yml", "r").map do |livro_serializado| 
YAML.load livro_serializado 
end 
end 
end 


O método carrega em sua primeira linha, configura o separador de linhas do 
arquivo para trabalhar com duas quebras ( nn), depois o arquivo livros .yml é 
aberto em modo leitura. A cada iteração o conteúdo serializado é transformado em 
uma instância de Livro através do método load da classe YAML. Como utilizamos 
o método map, o retorno do método carrega é um Array como todos os objetos 
que foram deserializados. 

Podemos então carregar os objetos serializados presentes no arquivo e adicioná- 
los no Array de objetos Livro da classe Biblioteca representado pela variável 


@livros: 


class Biblioteca 
def initialize 
@banco_de_arquivos = BancoDeArquivos.new 
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end 


def adiciona(livro) 
salva livro do 
livros << livro 
end 
end 


def livros por categoria(categoria) 
livros.select { |livro| livro.categoria == categoria } 
end 


def livros 
@livros ||= @banco_de_arquivos.carrega 
end 


def salva(livro) 
@banco_de_arquivos.salva livro 
yield 
end 
end 


Utilizamos a variável @livros com carregamento lazy, ou seja, só buscamos 
os objetos no BancoDeArquivos quando a variável for utilizada pela primeira 
vez, por isso removemos a inicialização da variável no construtor. Assim, as cha- 
madas sequentes retornam o conteúdo carregado pela primeira vez. Os métodos 
adicionae livros por categoria são os responsáveis por invocar o método 
privado livros, por isso não acessam mais diretamente a variável @livros. 


Método select 





O método select da API Enumerable percorre todos elementos existentes 
na coleção onde o método foi chamado, e retorna um Array contendo os elemen- 
tos iterados cuja a execução do bloco passado seja true, funcionando como uma 
espécie de filtro do objetos que compõe o Array. 

No exemplo acima, se existirem três objetos do tipo Livro (dois pertencentes a 
categoria : web e o outro da categoria :testes)e invocarmos o método select 
definindo que o retorno do bloco é a comparação da categoria do Livro com uma 
categoria :testes,o retorno será um Array contendo apenas livros cuja categoria 
for :testes: 
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biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 
biblioteca.adiciona Livro.new "Web Design Responsivo", "Tarcio Zemel", 
"45256", 240, 69.9, :web 
biblioteca.adiciona Livro.new "Web com JSF e JPA", "Gilliard Cordeiro", 


"543232", 270, 69.9, :web 


biblioteca.livros por categoria :testes 
# => Autor: Mauricio Aniche, Isbn: 123454, Páginas: 247, 
Categoria: testes 


6.5 PROXIMOS PASSOS 


Neste capitulo vimos um pouco sobre a API File do Ruby, aprendemos a criar e ler 
arquivos do disco. Também revimos alguns conceitos de serialização que estavam 
perdidos em nossa memória e aprendemos que em Ruby existem duas maneiras na- 
tivas de serializar objetos: YAML que é uma serialização mais fácil de ser lida por 
seres humanos e Marshall que serializa os dados em um formato binário. 

O próximo assunto será o compartilhamento de código entre as classes e objetos 
Ruby. Veremos maneiras de aplicar o princípio DRY (Dont Repeat Yourself) em 
nossos códigos utilizando técnicas existentes no principais frameworks e biblioteca 
do mundo Ruby. 
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Compartilhando Comportamentos: 
Herança, Módulos e Mixins 


Uma das principais característica de um bom design de código é a eliminação de 
duplicidades desnecessárias. O princípio DRY (Don't Repeat Yourself) criado por 
Andy Hunt e Dave Thomas, no excelente livro “The Pragmatic Programmer”, propõe 
que cada pequena quantidade de código deve possuir somente uma representação 
em todo o sistema. 

Em sistemas orientados a objetos, as classes são abstrações que permitem que 
determinados comportamentos sejam isolados juntos com os dados que representam 
uma entidade no sistema, na nossa aplicação, a classe Livro cumpre este papel, de 
maneira que todos os métodos criados estão disponíveis entre todas as instâncias 
criadas a partir da classe Livro. 

No futuro podemos decidir vender além de livros, outras mídias como DVD's, 
CD's etc. Estes objetos certamente possuem dados bastante parecidos, como por 
exemplo, o preço, já que estamos lidando com uma aplicação de vendas. Podemos 
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até mesmo criar relatório dos produtos que temos disponíveis, e precisamos criar 
uma classe que seja genérica para quando criarmos algum outro tipo de mídia, não 
precisarmos alterar a classe de relatório, ou mesmo outros pontos do sistemas que 
lidam com Produto. 

Neste capítulo veremos formas de compartilhar comportamentos em Ruby, o 
primeiro deles é bem conhecido dos desenvolvedores do mundo da orientação a ob- 
jetos: Herança. Também conheceremos uma maneira que é bem mais utilizada e 
conhecida pela comunidade Ruby, mas que não substitui o uso de herança, os mi- 
xins. 

Discutiremos as vantagens de cada uma destas abordagens e veremos quando 
devemos utilizar um ou outro. 


721 HERANÇA: COMPARTILHANDO COMPORTAMENTOS 
COM CLASSES 


Nos capítulos anteriores utilizamos bastante o método p para imprimir dados na 
saída padrão. Aprendemos que o método p sempre invoca um método chamado 
inspect no objeto que pedimos para ser impresso. O fato é que nós nunca imple- 
mentamos esse método em nenhuma das classes que criamos até agora. 

Quando invocamos qualquer método em um objeto, na verdade estamos en- 
viando uma mensagem para ele e solicitando que seja executado algum compor- 
tamento. A linguagem Ruby procura qual método deve ser executado e quando o 
encontra, executa o mesmo. Por exemplo, quando invocamos o método inspect 
em uma instância de Livro, o interpretador Ruby irá procurar o método na ins- 
tância que representa e possui todos os métodos definidos na classe Livro, caso 
não encontre, o interpretador tenta encontrá-lo em alguma super classe da classe 


Livro: 


p Livro.superclass # => Object 


E encontra o método inspect definido na classe Object, que é a superclasse 
default de todos os objetos que não estendem explicitamente de outra classe. 
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HERANÇA SIMPLES 


Em Ruby podemos fazer com que uma classe herde apenas de uma 
única outra classe, o que caracteriza o que chamamos de Herança Sim- 


ples. 











p Livro.superclass.methods & => [..., :inspect, ...] 





LISTANDO OS MÉTODOS DE UMA CLASSE 


O método methods retorna todos os métodos disponíveis para os 
objetos que são criados a partir da classe ou de subclasses. Podemos por 
exemplo, listar os métodos da classe Object e assim concluirmos que 
ela disponibiliza o método inspect para os objetos do tipo Livro, ja 
que Livro herda de object. 











Vamos começar a lidar com outros objetos em nossa loja virtual. Agora vamos 
criar DVD's, e já conseguimos pensar em abstrações para estas duas classes, por exem- 
plo, todo Livroe DVD possuem um titulo, valor euma categoria. Portanto 
vamos criar uma classe Midia, que ficará dentro do arquivo lib/midia. rb, e que 
também será a superclasse das classes Livro e DVD, que também não foi criada e 
deve ser adicionada no arquivo lib/dvd.rb: 


class Midia 
end 


# coding: utf-8 

class DVD < Midia 
attr_accessor :valor 
attr_reader :titulo 


def initialize(titulo, valor, categoria) 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 

end 
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def to s 


end 
end 


20L Título: #{@titulo}, Valor: #{@valor} 5 


# coding: utf-8 
class Livro < Midia 


attr_accessor :valor 


attr reader :categoria, :autor, :titulo 


def 


end 


def 


end 
end 


initialize(titulo, autor, isbn = "1", numero_de_paginas, 
valor, categoria) 

@titulo = titulo 

@autor = autor 

@isbn = isbn 

@numero_de_paginas = numero_de_paginas 

@categoria = categoria 

@valor = valor 


to_s 

"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: #{@numero_de_paginas}, 
Categoria: #{@categoria}" 


Não se esqueça de fazer o ‘require’ destas duas novas classes no arquivo 


lib/loja virtual.rb: 





require 
require 
require 
require 
require 
require 


File.expand_path('lib/midia') 
File.expand_path('lib/dvd') 
File.expand_path('lib/livro') 
File.expand_path('lib/biblioteca') 
File.expand_path('lib/relatorio') 
File.expand_path('lib/banco_de_arquivos') 


Quando criamos criamos uma classe que herda comportamento de outra, utili- 


zamos o caractere <. Definimos, por exemplo, que a classe Livro < Midia herda 


todos os comportamentos existentes na classe Midia e em todas as superclasses 


também. 
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As classes Livro e DVD definem um método acessor para o atributo valor 
e um método de leitura para o atributo titulo. Quando invocamos o método 
attr reader :titulo estamos definindo um método titulo para os objetos 
da classe Livro e DVD, no caso do método attr acessor :valor definimos 
dois métodos: valor e valor=(novo valor). Já que este código está sendo 
repetido, vamos extraí-lo para dentro da classe Midia e assim as classes Livro e 
DVD as herdarão: 


class Midia 
attr accessor :valor 
attr reader :titulo 
end 


# coding: utf-8 
class DVD < Midia 
def initialize(titulo, valor, categoria) 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
AQL Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


# coding: utf-8 
class Livro < Midia 
attr_reader :categoria, :autor 


def initialize(titulo, autor, isbn = "1", numero_de_paginas, 
valor, categoria) 
Otitulo = titulo 
@autor = autor 
@isbn = isbn 
@numero_de_paginas = numero_de_paginas 
@categoria = categoria 
@valor = valor 
end 


def to_s 
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"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: #{@numero_de_paginas}, 
Categoria: #{@categoria}" 
end 
end 


teste_e_design = Livro.new "TDD", "Mauricio Aniche", "123454", 247, 
69.9, :testes 


p teste_e_design.valor # => 69.9 
p teste_e_design.titulo # => "TDD" 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor # => 98.9 
p windows.titulo # => Windows 7 for Dummies 


7.2 HERANGA E VARIÁVEIS DE INSTÂNCIA 


As mídias da nossa loja virtual possuem um desconto particular de cada uma de- 
las que é aplicado ao seu valor. No método initialize da classe Livro va- 
mos definir uma variável de instância que guardará o valor do desconto, e faremos 
o mesmo no método initialize da classe DVD. Após isso definiremos um mé- 
todo valor com desconto diretamente na classe Midia, já que este será um 


comportamento padrão as duas mídias existentes: 


class Midia 
attr accessor :valor 
attr reader :titulo 


def valor com desconto 
@valor - (@valor * @desconto) 
end 
end 


# coding: utf-8 
class DVD < Midia 
def initialize(titulo, valor, categoria) 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
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@desconto = 0.1 
end 


def to_s 
J Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


# coding: utf-8 
class Livro < Midia 
attr_reader :categoria, :autor 


def initialize(titulo, autor, isbn = "1", numero_de_paginas, 
valor, categoria) 
Otitulo = titulo 
Gautor = autor 
Gisbn = isbn 
@numero_de_paginas = numero_de_paginas 
@categoria = categoria 
@valor = valor 
@desconto = 0.15 


end 
def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: #{@numero_de_paginas}, 
Categoria: #{@categoria}" 
end 


end 


teste_e_design = Livro.new "TDD", "Mauricio Aniche", "123454", 247, 
69.9, :testes 


p teste_e_design.valor_com_desconto # => 59.41 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_com_desconto # => 89.01 


O método valor com desconto existe nas instâncias de Livro e DVD 
como esperado. Porém existe algo interessante no código acima: o método 
valor com desconto acessa duas variáveis de instância, @valore @desconto, 
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que estão definidas nas subclasses. Em outras linguagens este comportamento não 
funcionaria, exceto se as variáveis estivessem também definidas na classe Midia. 

Este comportamento é bastante particular da linguagem Ruby, quando falamos 
de variáveis de instância e herança. Você vai entender isso melhor nas próximas 
linhas. 

As classes Livro e DVD assim como outras mídias que surgirão, terão um valor 
de desconto pré-definido em 10%. Sendo assim, vamos criar uma variável de ins- 
tância chamada desconto dentro da classe Midia e inicializá-lo com o valor 
0.1: 


class Midia 
attr accessor :valor 
attr reader :titulo 


def initialize 
@desconto = 0.1 
end 


def valor_com_desconto 
@valor - (@valor * @desconto) 
end 
end 


Podemos assim, eliminar a variável @desconto da classe DVD: 


# coding: utf-8 
class DVD < Midia 
def initialize(titulo, valor, categoria) 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
ZOL Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


Agora podemos testar novamente o método valor com desconto eo com- 
portamento deve ser obviamente o mesmo: 
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windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
p windows.valor. com desconto 
# => TypeError: nil can't be coerced into Float 


Aconteceu um erro que não esperávamos, e ele nos indica que a varia- 
vel desconto está nula. Isso aconteceu porque não invocamos o método 
initialize da superclasse que inicializa a variável desconto. Resolvemos isso 
invocando o método super dentro do initialize da classe DVD que invocará 
por sua vezo initialize da classe Midia: 


class DVD < Midia 
def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
0L Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_com_desconto # => 89.01 


Porém ainda não ficou claro como o método valor com desconto possui 
acesso a variável @valor. Todo o objeto Ruby possui um conjunto de variáveis de 
instância, e estas variáveis não são definidas na classe, mas sim quando invocamos 
algum método que as cria, que na maioria dos casos acaba sendo o próprio método 
initialize, que é um simples método como outro qualquer. 

Pelo motivo de não serem definidas na classe, variáveis de instância não são her- 
dadas por subclasses. Quando invocamos o método initialize da superclasse 
(através do método super) uma variável de instância é criada no escopo onde foi 
chamado, no exemplo a variável é criada dentro do objeto DVD. 

Por este motivo o método valor com desconto funciona. Ao criarmos 
um objeto do tipo Livro ou DVD, o mesmo possui uma variável de instância 
chamada valor e outra chamada desconto, quando invocamos o método 
valor com desconto as variáveis referenciadas pelo método são as do objeto 
onde o método foi chamado: Livro ou DVD: 
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teste e design = Livro.new "TDD", "Mauricio Aniche", "123454", 247, 
69.9, :testes 


p teste_e_design.valor_com_desconto # => 59.41 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_com_desconto # => 89.01 


Podemos provar essa característica da linguagem, se tentarmos invocar o método 


valor com desconto em uma instância de Midia: 


midia = Midia.new 
midia.valor com desconto & => undefined method ~*' for nil:NilClass 


O erro indica que a variável @valor está nula. E faz bastante sentido, pois em 
nenhum momento nós criamos uma variável @valor no conjunto de variáveis de 
um objeto do tipo Midia. 

Para resolver este problema basta inicializar objetos do tipo Midia com um 
valor padrão, por exemplo: 


class Midia 
attr accessor :valor 
attr reader :titulo 


def initialize 
@desconto = 0.1 
@valor = 10.0 
end 


def valor_com_desconto 
@valor - (@valor * @desconto) 
end 
end 


midia = Midia.new 
midia.valor_com_desconto # => 9.0 


Agora que o método initialize da classe Midia define uma variá- 
vel @valor e o método initialize da classe DVD define a mesma variá- 
vel com outro valor, qual será o seu valor no momento da chamada ao método 
valor com desconto em uma instância de DVD? Vamos conferir: 
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windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 


p windows.valor com desconto & => 89.01 


Exatamente o mesmo valor que antes. Isso acontece porque não herdamos a 
variável @valor no momento da chamada ao método super, apenas foi criada 
uma variável @valor valendo 10.0 no conjunto de variáveis de instância do objeto 
windows. Como logo em seguida redefinimos o valor da variável @valor para 89.01 
(valor do atributo recebido no método initialize), este será o valor no momento 
da execução do método valor com desconto. 

Esta é uma característica importante de herança em Ruby, pois não herdar va- 
riáveis de instância exclui a possibilidade de que uma delas seja utilizada em uma 
subclasse, sombreando uma variável que foi definida na superclasse. 


Como invocar o método initialize da superclasse 


O primeiro ponto que devemos ressaltar é que Ruby não possui construtores. 
Existe um método initialize que é executado quando criamos um objeto ao 
invocar o método new em uma constante definida. 


Como Ruby possui apenas métodos, quando desejamos invocar o método 
initialize da superclasse, devemos invocá-lo através da palavra chave super. 
Porém existe uma pequena armadilha. 

Quando invocamos o initialize da superclasse apenas com super sem os 
parenteses, o interpretador Ruby tentará invocá-lo passando os mesmos parâmetros 
recebidos pelo método initialize da subclasse, por exemplo: 


# coding: utf-8 
class DVD < Midia 
def initialize(titulo, valor, categoria) 
super # invocando super sem os parâmetros 
@titulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
J Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 
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windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
# => ArgumentError: wrong number of arguments (3 for 0) 


Os parâmetros titulo, valor e categoria são repassados para o método 
initialize da classe Midia que não recebe nenhum argumento, por este motivo 
o erro. 

Para resolver basta adicionar os parenteses na chamada super () que o método 
initialize da superclasse será chamado sem a passagem de nenhum argumento. 
Seo método initialize da superclasse recebe argumentos, você deve passá-los e 
neste caso o uso dos parenteses é opcional. 


7.3 OS CUSTOS NO USO DA HERANÇA 


A maioria dos programadores Ruby já projetaram classes que utilizam herança para 
modelar as classes que escrevem no dia a dia. De fato esta maneira de projetar classes 
é muito comum e quase nunca pensamos nos problemas que essa abordagem pode 
nos trazer. 


Não existe encapsulamento entre os objetos 


Utilizamos herança geralmente para modelar classes nas quais desejamos com- 
partilhar comportamentos, mas o que muita gente não sabe é que muitas vezes aca- 
bamos compartilhando implementação. Entre outras coisas, isso significa que não 
importa de quantas classes você herde, todos os métodos e o estado do seu objeto 
são definidos em um único namespace. E se você não tomar o devido cuidado, essa 
perda de encapsulamento entre os objetos podem trazer grandes dores de cabeça. 

Para testar esse comportamento, vamos refatorar o método 


valor com desconto 


class Midia 
attr accessor :valor 
attr reader :titulo 


def initialize 
@desconto = 0.1 
@valor = 10.0 
end 


def valor_com_desconto 
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@valor - desconto 
end 


private 


def desconto 
@valor * @desconto 
end 
end 


Apenas extraimos parte do código para um método privado chamado 
desconto, o comportamento continua o mesmo. Mas é desta refatoração que vem 
o problema. Hoje, apenas as classes Livro e DVD estendem a classe Midia, porém, 
no futuro outras mídias podem ser criados, e em alguma destas mídias, o desenvolve- 
dor resolve criar, por exemplo, um método de leitura que retorna o valor do desconto 
definido, sem saber que existe um outro método com o mesmo nome, definido na 


classe Livro: 


class CD < Midia 
attr reader :desconto 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
@desconto = 0.3 

end 

end 


windows = CD.new "Windows 95", 239.9, :sistemas_operacionais 
p windows.valor_com_desconto # => 239.6 


Perceberam o problema? O método desconto definido na classe Livro foi 
invocado. Mas por qué? 

Lembre-se que quando invocamos um método em Ruby, estamos na verdade 
enviando uma mensagem para um objeto, no momento em que invocamos o mé- 
todo valor com desconto, ele percebe que tem que invocar um outro método 
chamado desconto para completar sua operação. Neste momento o interpretador 
Ruby, procura por este método na classe CD. Ao encontrá-lo, o método é execu- 
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tado e o seu retorno é enviado para o método valor com desconto que efetua a 
subtração com a variável @valor e retorna este resultado final. 

O principal problema aqui, é que em Ruby não existe o conceito de encapsula- 
mento entre os objetos envolvidos no uso da herança. O mesmo problema acontece 
com variáveis de instância (que por padrão são sempre privadas), que podem ser 
alteradas nas superclasses, e afetar algum outro comportamento das subclasses que 
utilizam as variáveis alteradas. 


Reuso e customização podem ser armadilhas 


Algumas classes ancestrais ou superclasses fornecem métodos que são projeta- 
dos para serem substituídos pelas classes descendentes ou subclasses. Este compor- 
tamento quando bem definido e explicado pode ser muito útil, já que na superclasse 
podemos definir a maior parte dos comportamentos deixando apenas alguma parte 
do comportamento para ser customizado pelas subclasses. Este tipo de comporta- 
mento é tão comum que virou um Design Pattern chamado Template Method. 

Porém, estas customizações podem nos trazer alguns problemas. O código es- 
crito até o momento possui uma falha devido as customizações disponíveis em al- 
gumas API do Ruby. Vamos ver um exemplo de código que demonstra o problema: 


class CD < Midia 
def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 
end 


windows = CD.new "Windows 95", 239.9, :sistemas_operacionais 

p windows 

# => H<CD:0x007ff86b91ec20 @desconto=0.1, @valor=239.9, 
Otitulo="Windows 95", 
@categoria=:sistemas_operacionais> 


puts windows # => #<CD:0x007ff86b91ec20> 


Internamente, sabemos que o método p chama o método inspect do objeto 
windows e o método puts por sua vez chama o método to s. O resultado exi- 
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bido no terminal ao executar o código acima, é o retorno da implementação destes 
métodos. 

O método inspect herdado da classe object fornece um saída para depu- 
rarmos o conteúdo do objeto, já o método to s também da classe Object é um 
método que na maioria das vezes deve ser sobrescrito afim de tornar-se mais útil 
quando o invocamos. Foi o que fizemos com os objetos Livro e DVD, agora vamos 
fazer o mesmo com os objetos do tipo CD: 


class CD < Midia 
def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
AOL Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


windows = CD.new "Windows 95", 239.9, :sistemas_operacionais 
p windows # => Titulo: Windows 95, Valor: 239.9 


Aparentemente não existe nenhum problema com este código. Entretanto, o mé- 
todo inspect da classe Object funciona de uma maneira um pouco deselegante 
no Ruby 1.9, definindo sua própria implementação do método to. s deixando al- 
guns efeitos colaterais em nosso código: 


windows = CD.new "Windows 95", 239.9, :sistemas operacionais 
puts windows # => Titulo: Windows 95, Valor: 239.9 


Exatamente a mesma saída do método inspect. A própria documentação do 
inspect fala sobre esta decisão em relação ao design no código. Resumidamente, 
quando determinado objeto não sobrescreve o método to s,o método inspect 
possui seu retorno padrão que vimos anteriormente, caso contrário, ele apenas de- 
lega a chamada ao to s. 

A maneira de resolver este problema é sobrescrever o método inspect e definir 
sua própria implementação que pode ser parecida com a original. 
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Indiretamente, isso pode afetar a hierarquia de classes criadas. Se por exemplo, 
a classe Midia sobrescrever o método to s, todas as classes que a estendem, her- 
darão o método to s e por consequência se quisermos uma implementação do 
método inspect parecida com a original, vamos ter que criá-la nas subclasses. 

Com esse conhecimento sobre a herança em Ruby, temos embasamento o sufi- 
ciente para conhecermos um novo recurso, chamado módulos, que são a base para 
uma alternativa a herança, conhecido como mixings. 


7.4 MÓDULOS 


Namespace 


A classe Biblioteca que criamos nos capítulos anteriores, armazena um Array 
de objetos do tipo Livro. Já que está classe apenas armazena objetos, podemos 
batizá-la com um nome mais sugestivo, mas chamá-la apenas de Set, ou seja, um 
conjunto, neste caso de livros: 


class Set 
def initialize 
Cbanco de arquivos = BancoDeArquivos.new 
end 


def adiciona(livro) 
salva livro do 
livros << livro 
end 
end 


def livros por categoria(categoria) 
livros.select { |livro| livro.categoria == categoria } 
end 
def livros 
@livros ||= @banco_de_arquivos.carrega 
end 


private 


def salva(livro) 
@banco_de_arquivos.salva livro 
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yield 
end 
end 


conjunto de livros = Set.new 
conjunto de livros.adiciona Livro.new "TDD", "Mauricio Aniche", 
"123454", 247, :testes 


O que fizemos no código acima é muito perigoso, porque a corelib do Ruby já 
possui uma classe chamada Set, sendo assim, o código acima abre a classe e altera 
completamente os comportamentos definidos pelos engenheiros que projetaram a 
classe. Se quisermos mesmo que a classe que guarda os objetos Livro tenha o nome 
Set, o único jeito é adicionar um namespace para diferenciar a classe set do Ruby 
com a classe set do sistema de venda de livros. 

É importante ressaltar que as bibliotecas que você utilizará quando programar 
em Ruby podem possuir classes cujos nomes conflitam com as próprias classes já 
existentes no código fonte que escrevemos. Os módulos permitem que classes e ou- 
tros módulos possuam o mesmo nome evitando colisões. Podemos pensar nos na- 
mespaces como diretórios no projeto onde separamos os arquivos que representam 
cada classe ou módulo. 

Algo muito comum acontece em código Java, que utilizam os pacotes para dis- 
tribuir e organizar código. Além de evitar possíveis conflitos com nomes de classes 
já existentes na bibliotecas existentes. 

Vamos então criar um módulo cuja função é criar um namespace, que neste caso 
pode ser algo que identifique que a classe pertence ao sistema de vendas. Vamos 
batizar o sistema como VendaFacil: 


module VendaFacil 
end 


Módulos em Ruby seguem as mesmas regras de definição de nomes de classes, a 
diferença é o uso da palavra module. 


Agora basta colocar a classe Set no namespace do módulo VendaFacil: 


module VendaFacil 
class Set 
def initialize 
Cbanco de arquivos = BancoDeArquivos.new 
end 
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# Outros métodos 
end 
end 


Utilizamos o operador Constant lookup : : para acessarmos uma classe ou cons- 
tante que foi definida dentro de namespace: 


# acessando classe Set do namespace VendaFacil 
conjunto de livros = VendaFacil: :Set.new 


conjunto_de_livros.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, :testes 


Você pode utilizar o Constant lookup para encontrar classes ou até mesmo ou- 
tros módulos no nível que desejar. Se a classe ou módulo que você deseja acessar 
estiver em um namespace VendaFacil, Util, Set podemos acessá-lo utilizando: 
VendaFacilUtilSet. 

Utilizar módulos como namespaces é a forma padrão de organizar bibliotecas 
e classes em Ruby. Esta é uma excelente prática que recomendo que seja seguida 
conforme seu código for crescendo e as possibilidades de conflitos aumentarem. 


Mixins 
Precisamos formatar o atributo valor dos objetos Livro, CDe DVD respei- 


tando as regras de formatação do Real. Podemos definir o método formatador na 
classe Midia que é a superclasse de todas as classes citadas anteriormente: 


class Midia 
def valor formatado 
"R$ #{@valor}" 
end 
end 


O problema de criar o método valor formatado dentro da classe Midia e 
que se precisarmos utilizar este comportamento em classes que não fazem parte da 
hierarquia, seria necessário duplicar o código, o que seria extremamente ruim, pela 
necessidade de manter o mesmo código em várias partes do sistema. 

Os módulos tem outra utilidade, muito importante e bastante utilizada nas prin- 
cipais bibliotecas e frameworks existentes, como por exemplo, o Rails. Os mixings 
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eliminam a necessidade de herança para compartilhar código, além de permitir uma 
espécie de herança múltipla já que podemos utilizar vários módulos em uma mesma 
classe. 

Módulos podem definir métodos de classe e de instância. Então isso quer dizer 
que podemos instanciar módulos? Não. Módulos não podem ser instanciados, suas 
únicas utilidades são fornecer namespaces e compartilhar código. O que fazemos é 
um include do módulo criado em uma ou várias classes, e assim as classes que in- 
cluíram aquele módulo passam a ter em sua interface todos os métodos de instância 
definidos no módulo incluído. Nós misturamos os métodos na classe que incluiu o 
módulo, daí vem o nome mixings. 

Podemos criar o método valor formatado dentro de um módulo e utilizá-lo 
em vários lugares do sistema: 


# lib/formatador_moeda.rb 
module FormatadorMoeda 
def valor_formatado 
"R$ #{@valor}" 
end 
end 


Repare que no método valor_formatado que foi criado, nos referimos a uma 
variável de instância chamada @valor. Lembre-se que os métodos criados dentro 
de módulos, assim como na herança, assumem o escopo onde foram invocados. Por 
exemplo: 


# coding: utf-8 
class Livro < Midia 


# todos os métodos de instância são 
# incluídos nos objetos Livro 


include FormatadorMoeda 


def initialize(titulo, autor, isbn = "1", numero de paginas, 
valor, categoria) 
@titulo = titulo 
@autor = autor 
@isbn = isbn 
@numero_de_paginas = numero_de_paginas 
@categoria = categoria 
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@valor = valor 
@desconto = 0.15 
end 


def to_s 
"Autor: #{@autor}, Isbn: #{@isbn}, 
Paginas: #{@numero_de_paginas}, 
Categoria: #{@categoria}" 
end 
end 


tdd = Livro.new "TDD", "Mauricio Aniche", "123454", 247, :testes 
tdd.valor_formatado # => R$ 247 


O objeto tdd possui o método valor formatado definido no módulo que 
incluímos na classe Livro e ao invocarmos, a variável valor utilizada é a variável 
definida no objeto Livro que invocamos o método. 





RESOLVENDO AMBIGUIDADE DE MÉTODOS 


Uma das dúvidas mais comuns para quem está começando a utilizar 
mixings é como é feita a procura do método que tem que ser executado, 
ou seja, se definirmos um método valor formatado naclasse Livro 
ou dentro de algum outro mixing feito na classe Livro qual método será 
executado. 

O interpretador Ruby primeiro procura o método dentro da classe do 
objeto, depois nos mixings incluídos na classe, e só então na superclasse e 
seus mixings. Se a classe possuir múltiplos módulos incluídos, no último 
módulo incluído será feita a primeira busca, depois no penúltimo e assim 


por diante. 











É válido ressaltar que quando fazemos o include do módulo 
FormatadorMoeda, fazemos apenas uma referência que a classe Livro tem 
os comportamentos definidos no módulo. O interpretador Ruby não copia os 
métodos de instância para dentro da classe, ao invés disso, da classe Livro para o 
módulo FormatadorMoeda. Isso implica que se o módulo for incluso em várias 
classes, ao alterarmos algum comportamento definido nele, todas as classes que 
incluem o módulo terão seus comportamentos alterados também. 
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Variáveis de instância e mixings 


Módulos não possuem variáveis de instância, pois não podem ser instanciados. 
Precisamos nos lembrar de como as variáveis de instância são funcionam em Ruby: 
a primeira menção para uma variável precedida com €, cria um variável de instância 
no objeto atual. 

Para os mixings, isso significa que o módulo que você inclui em uma classe, pode 
definir variáveis de instância no objeto da classe que está sendo instanciado. Entre- 
tanto este comportamento pode trazer erros inesperados já que as variáveis de ins- 
tância definidas no módulo, podem conflitar com variáveis de instância definidas 
na classe que o incluiu, ou pode até mesmo conflitar variáveis definidas em outros 
módulos que foram incluídos na classe. 

A dica para evitar este tipo de problema, é utilizar algum tipo de prefixo no no- 
mes das variáveis afim de criar um nome único. Mas este é um problema muitas 
vezes inevitável quando utilizamos mixings, já que podemos incluir quantos módulo 
quisermos. Portanto, tenha cuidado e veja se realmente faz sentido você incluir um 
módulo só para não repetir código. 


Incluindo módulos em objetos existentes 


Se você precisa incluir comportamentos existentes em um módulo apenas em 
alguns objetos, pode fazer isso utilizando a palavra chave extend ao invés de 
include. Por exemplo, dado que temos dois objetos do tipo DVD criados, e 
desejamos que apenas um deles possua os comportamentos definidos no módulo 


FormatadorMoeda 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
linux = DVD.new "Linux for Dummies", 13.9, :sistemas operacionais 


windows .extend FormatadorMoeda 
windows.valor formatado # => R$ 98.9 


linux.valor formatado 
# => NoMethodError: undefined method “valor formatado! for "linux":DVD 


O método extend inclui os métodos de instância do módulo apenas para o 
objeto windows, o outro objeto linux, apesar de ser da mesma classe, não possui 
o método. 
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Utilizando módulos da biblioteca padrão do Ruby 


Existe uma grande variedade de módulos na biblioteca padrão do Ruby. Alguns 
deles, muito poderosos nos permitem escrever menos código e executar tarefas com- 
plexas utilizando apenas um include. O principal motivo é que eles interagem com 
código da classe que os inclui. As apis de coleção do Ruby, por exemplo, Array, Set, 
Hash possuem uma variedade de método como: sort, include?, select, etc. 
Se olharmos o código da classe Biblioteca, podemos visualizar o quão legal seria 
termos todos estes métodos e podemos invocá-los diretamente em uma instância 
de Biblioteca ao invés de retornar um Array através do método livros e daí 
então fazer as operações desejadas. 


Todos estes métodos podem ser incluídos na classe Biblioteca incluindo o 





módulo Enumerable, e a única coisa que necessária, será criar um método each 
que itera e retorna todos os elementos do Array de Livro. 


class Biblioteca 
include Enumerable 


def initialize 
Cbanco de arquivos = BancoDeArquivos.new 
end 


def adiciona(livro) 
salva livro do 
livros << livro 
end 
end 


def livros por categoria(categoria) 
livros.select { |livro| livro.categoria == categoria } 
end 


def livros 
@livros ||= @banco_de_arquivos.carrega 
end 


# método each que possibilita que os outros métodos 


# do módulo Enumerable funcionem em uma instância de Biblioteca 
def each 
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livros.each { |livrol yield livro + 
end 


private 


def salva(livro) 
Obanco de arquivos.salva livro 
yield 
end 
end 


Agora, se precisarmos saber a somatória total de todos os livros existentes dentro 
da Biblioteca, basta utilizamos o método inject que itera sobre os elementos 
de um Array e guarda a somatória em uma variável: 


biblioteca = Biblioteca.new 


biblioteca.adiciona Livro.new "TDD", "Mauricio Aniche", "123454", 
247, 69.9, :testes 
biblioteca.adiciona Livro.new "Web Design Responsivo", "Tarcio Zemel", 


"45256", 240, 69.9, :web 


p biblioteca.inject(0) { |tot, livro| tot += livro.valor } # => 139.8 





A classe Biblioteca se comporta como um Enumerable, possui todos os 
métodos que um Array, por exemplo. Mas neste caso, todos os métodos do módulo 





Enumerable utilizam o método each que itera pela variável Glivros. 


7.5 INDO MAIS A FUNDO: CONSTANT LOOKUP DE DENTRO 
PARA FORA 


É muito importante entendermos que as constantes (classes, módulos, etc) são pro- 
curadas do namespace mais interno, partindo para o mais externo até chegar ao na- 
mespace global. Isso é muito confuso às vezes, e por sorte, aparecerá no momento 
da execução do código. 

Por exemplo, vamos alterar a classe VendaFacil::Set para inicializar a va- 


riável @livros com um Array vazio utilizando outra sintaxe: 


module VendaFacil 
class Set 
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def initialize 

@livros = Array .new 

Cbanco de arquivos = BancoDeArquivos.new 
end 


# Outros métodos 
end 
end 


Se executarmos este código no irb e imprimir de qual tipo é a variável 
@livros, veremos que continua sendo do tipo Array: 


conjunto de livros = VendaFacil::Set.new 
p conjunto de livros.livros.class # => Array 


Este comportamento parece Óbvio, porém, se existe um pequeno pedaço de có- 
digo como o abaixo as coisas podem ser alteradas de forma inesperada: 


module VendaFacil 
module Array 
# alguns métodos aqui 
end 
end 


O desenvolvedor que escreveu o código acima, se preocupou com o fato de já 
existir uma constante Array definida e organizou o código adicionando o names- 
pace VendaFacil nacriação desta nova constante. Porém, esta mudança nos causa 
pequenas dores de cabeça. Ao tentar chamar o método new na classe Array dentro 
da classe VendaFacil::Set um erro será lançado: 


VendaFacil::Set.new 
# => NoMethodError: undefined method “new' for VendaFacil::Array:Module 


Existem diversas maneiras de solucionarmos este problema. Uma delas é voltar 
a inicialização do Array para o código anterior []. A outra é alterar o nome do mó- 
dulo VendaFacil::Array para algum nome que não conflite com classes da core 
standard library do Ruby, o que na maioria das vezes é a melhor solução. Se nenhuma 
das opções anteriores for possível, podemos utilizar explicitamente o constant lookup 
do namespace global: 
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module VendaFacil 
class Set 
def initialize 
@livros = ::Array.new 
@banco_de_arquivos = BancoDeArquivos.new 
end 


# Outros métodos 
end 
end 


Adicionado :: antes da chamada ao Array .new forcará o interpretador Ruby 
a ignorar os namespaces internos e externos, e procurar diretamente no namespace 
global, onde estao as constantes que nao possuem namespace. 

No geral, quando utilizamos lookup absolute de constantes é um sinal que deve- 
riamos utilizar outros nomes para as classes que conflitam. 


7.66 Duck TYPING: O POLIMORFISMO APLICADO NO RUBY 


Sistemas de tipos é uma parte fundamental em todas as linguagens de programação, 
e a maneira que cada linguagem o implementa influencia o design das classes do 
sistema. 

Linguagens estaticamente tipadas como C++ e Java fazem com que pensemos 
em objetos como abstração de estrutura de dados e comportamentos, e não existe de 
fato uma grande diferença entre os objetos criados e o seu tipo, eles são intimamente 
ligados. 

Porém, não são todas as linguagens que se comportam deste maneira. Ruby, por 
exemplo, é uma linguagem que possui tipagem dinâmica, que permite que as classes 
sejam modeladas e lidem com um estilo de tipo conhecido como Duck Typing. 

Duck Typing considera o que um objeto pode fazer e não de qual tipo ele é, que- 
brando a ligação com a classe do objeto criado. Agora quando escrevemos um mé- 
todo, ou iteramos um Array, temos que pensar no que o objeto pode fazer, igno- 
rando seu tipo. Vamos tomar como exemplo a classe Biblioteca, que atualmente 
guarda vários objetos do tipo Livro. Devemos lidar com objetos que sejam mídias, 
ou seja, Livro, DVD e CD. Mas será que nosso código atualmente não suporta esses 
outros “tipos"? Vamos ver: 


biblioteca = Biblioteca.new 
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windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
biblioteca.adiciona windows 


biblioteca.each do |midial| 
p midia.titulo # => Windows 7 for Dummies 
end 


Repare que não houve necessidade de alterarmos sequer uma linha de código no 
método adiciona e também no método each. Isso acontece primeiro porque o 
interpretador Ruby não se importa com o tipo de objeto passado como argumento, 
segundo porque os métodos não esperam nenhum comportamento específico dos 
objetos que estão sendo incluídos. Isso significa que podemos passar qualquer tipo 
de objeto na chamada do método: 


class Revista 
attr reader :titulo 


def initialize(titulo) 
Otitulo = titulo 
end 
end 


biblioteca = Biblioteca.new 
mundo j = Revista.new "MundoJ" 
biblioteca.adiciona mundo. j 
biblioteca.each do |qualquer objeto! 

p qualquer objeto.titulo # => MundoJ 


end 


Porém, para o método livros por categoria, que está com um nome de- 
fasado, o que importa não é o tipo, mas o que os objetos guardados na variável 
@livros podem fazer. 


biblioteca = Biblioteca.new 


mundo j = Revista.new "MundoJ" 
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biblioteca.adiciona mundo. j 


biblioteca.livros por categoria :testes 
# => NoMethodError: undefined method “categoria” for "mundo j":Revista 


O método livros por categoria espera que os objetos do Array 
@livros tenham um método categoria, porém, o recém criado objeto Revista 
possui apenas um método modelo, ou seja, é um objeto que definitivamente não 
deveria estar dentro da variável @1ivros pois não possui os comportamentos ne- 


cessários. 


Verifique manualmente os tipos dos objetos 


Caso precise executar comandos apenas para determinados tipos, é possível ve- 
rificar o tipo de um objeto de alguns maneiras. A primeira forma foge um pouco da 
estilo de tipagem imposto pelo duck typing, porque faz um verificação explícita pelo 
classe do objeto. Vamos aproveitar para renomear as variáveis e métodos ligadas ao 


nome livro: 


class Biblioteca 
include Enumerable 


def initialize 
Cbanco de arquivos = BancoDeArquivos.new 
end 


def adiciona(midia) 
salva midia do 
midias << midia 
end if midia.kind of? Midia 


end 


def midias por categoria(categoria) 
midias.select { |midia| midia.categoria == categoria } 
end 


def midias 


@midias ||= @banco_de_arquivos.carrega 
end 
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def each 
midias.each { |midia|] yield midia + 
end 


private 


def salva(midia) 
Cbanco de arquivos.salva midia 
yield 
end 
end 


O método kind of? retorna true se o objeto for um tipo ou subtipo da cons- 
tante passado como argumento, em nosso exemplo, da constante Midia. Com a ve- 
rificação incluída no método adiciona, são aceitos apenas objetos do tipo Midia, 
Livro, DVDe CD. 


biblioteca = Biblioteca.new 

windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
biblioteca.adiciona windows 

mundo j = Revista.new "MundoJ" 

biblioteca.adiciona mundo_j # não inclui o objeto mundo_j 


biblioteca.each do |midial| 
p midia.titulo # => Windows 7 for Dummies 
end 


Caso desejemos incluir objetos de outros tipos (por exemplo, Revista) que 
não são subtipos de Midia, devemos alterar o método adiciona e fazer a verifi- 
cação por estes outros tipos, ou seja, perdemos todo o poder do duck typing que é 
justamente evitar este tipo de verificação e importar-se apenas com o que o objeto 
pode fazer. 

Podemos permitir que sejam incluídos qualquer tipo de objeto e fazer a verifica- 
ção apenas pelos métodos: 


class Biblioteca 
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include Enumerable 


def initialize 
Obanco de arquivos = BancoDeArquivos.new 
end 


def adiciona(midia) 
salva midia do 
midias << midia 
end 
end 


def midias por categoria(categoria) 
midias.select do |midia| 
midia.categoria == categoria if midia.respond_to? :categoria 
end 
end 


def midias 


@midias ||= @banco_de_arquivos.carrega 
end 
def each 

midias.each { |midia| yield midia + 
end 
private 


def salva(midia) 
@banco_de_arquivos.salva midia 
yield 
end 
end 


Com esta mudança, ao executarmos o método adiciona podemos pas- 
sar qualquer objeto como parâmetro. Porém, se executarmos o método 
midias por categoria apenas os objetos que possuem ( respond to?) o mé- 
todo categoria são considerados na comparação, independente do seu tipo. 

A vantagem do uso do duck typing pode ser constatada ao criar testes de unidade 
paraaclasse Biblioteca, porque poderíamos passar mocks, que possuem uma im- 
plementação fake do método categoria, que permitiria que os comportamentos 
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fossem testados isoladamente. 


7-7 HERANCA OU MIXING? QUAL DEVO USAR? 


Módulos e herança no geral servem para compartilharmos código e evitarmos assim 
a duplicidade de partes do sistema. Mas a pergunta principal é: qual delas devo 
escolher? 

Está é uma das típicas questões, como muitas outras, que a resposta deve ser: 
depende. Com a experiência que ganhamos ao longo do anos como desenvolvedor, 
tendemos a escolher uma das alternativas. Mas o importante é sempre lembrar que 
não existe bala de prata, e não se esquecer quais são os pontos fracos e fortes de cada 
uma das abordagens. 

Classes em Ruby estão relacionados a ideia de tipos. Quando criamos um objeto 
“texto” dizemos que ele é do tipo String, ou quando criamos um objeto [1, 3] 
dizemos que ele é do tipo Array. Quando criamos classes, estamos definindo no- 
vos tipos, e quando utilizamos herança, criamos um subtipo de algum outro tipo já 
existente. Se temos um objeto carro, podemos dizer que ele é um Veículo, ou 
seja, tudo que um Veículo pode fazer,o carro faz. 

Portanto, quando criamos subtipos, estamos definindo relacionamentos é um. 
Porém, nos domínios da maioria das aplicações não existem este tipo de relaciona- 
mento. O mais comum é dizer que um objeto tem um ou usa um outro objeto para 
executar seus comportamentos, ou seja, na maioria das vezes utilizamos composição 
e não herança. 

Além do que herança nos traz graves problemas de acoplamento. Qualquer al- 
teração na superclasse, pode quebrar todas as subclasses, que muitas vezes não estão 
sob nosso controle. Comportamentos definidos na superclasse podem vazar para 
quem utiliza as subclasses, e espalhar estas regras por todos os lados na aplicação, o 
que inibe ainda mais as mudanças e evolução do sistema. 

Mixings possuem basicamente os mesmos problemas que herança, ao incluir- 
mos um módulo em uma classe, ela passa a ter todos os comportamentos definidos 
no módulo, se quisermos alterar algum destes métodos, vamos quebrar todos os 
códigos que invocam este método através de instâncias de classes que mixaram os 
comportamentos deste módulo. 


Porém eu vejo algumas vantagens de utilizar mixings e não herança: 


e Módulos podem ser gerenciados em tempo de execução através do método 
include, enquanto herança é definido no momento da escrita da classe; 
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e Módulos são mais fáceis de testar unitariamente de maneira isolada; 


e Módulos nos permite utilizar metaprogramação (capitulo 8) para definir Do- 
main Specific Languages; 


e Módulos são classes que não podem ser instanciadas, eles existem apenas para 
adicionar funcionalidades para classes já existentes. 


Hoje eu usaria herança apenas em casos esporádicos onde o relacionamento é 
um realmente for comprovado. No caso de querer apenas compartilhar compor- 
tamentos entre várias classes, eu usaria mixings. Porém, lembrando os problemas 
que ambas provocam no design da aplicação, trazendo grande acoplamento entre os 
componentes. 

A melhor solução é utilizar composição para reutilizar acoplamento, mas a co- 
munidade Ruby não utiliza muito esta prática, exceto alguns casos raros, a maioria 
dos códigos utilizam mixings. 
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Metaprogramação e seus segredos 


A metaprogramação permite que você não fique limitado às abstrações que a lingua- 
gem lhe oferece, permite que você vá além e crie novas abstrações sobre a linguagem 
Ruby, permite basicamente que você crie Domain Specific Languages - DSL, a fim de 
facilitar a leitura e escrita do código da sua aplicação. 

A grande maioria dos bons programadores Ruby utilizam técnicas de metapro- 
gramação para criar essa simplicidade de código. Porém, esta é uma técnica que leva 
um bom tempo para ser entendida, pois é necessário conhecimento da linguagem 
Ruby como um todo. Neste capítulo vou mostrar como utilizar metaprogramação a 
favor do seu código, utilizando as suas principais técnicas. 

Metaprogramação é um conteúdo muito extenso que exigiria um único livro só 
para contar todos os seus detalhes. Com o conteúdo que você verá a partir de agora, 
será capaz de criar suas próprias DSL e poupar várias linhas de código. 
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8.1 ENTENDA O SELF E METHOD CALLING 


Ruby possui um conceito de current object representando pela variável self. Esta 
variável possui dois papéis importantes em todo código Ruby, inclusive na metapro- 
gramação. 


Variáveis de instância 


O self é responsável por armazenar as variáveis de instância de um objeto. 
Quando tentamos acessar uma variável de instância, o Ruby irá procurar por ela 
dentro do objeto self: 


class Revista 
def initialize(titulo) 
Otitulo = titulo 
end 


def titulo 
Otitulo 
end 
end 


mundo j = Revista.new "MundoJ" 
p mundo j.titulo & => MundoJ 


A objeto referenciado por mundo. 5 possui uma variável de instância titulo, 
que está associado ao objeto self. Quando invocamos o método titulo, a variá- 
vel acessada está dentro do self. 


Method Calling 


A variável self possui um papel importante nas chamadas de método que fa- 
zemos nos objetos. Quando invocamos um método em algum objeto, dizemos que 
estamos enviando uma mensagem para que aquele objeto execute alguma ação, esse 
objeto chamamos de “receiver (receptor) da chamada”. Quando executamos o código 
mundo j.titulo,oobjeto mundo jéoreceivere titulo é a ação que queremos 
que seja executada. 

Quando executamos a chamada a algum método sem explicitar qual é o receiver, 
o interpretador Ruby assume que o receiver é o current object ( self). Por exemplo: 
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# coding: utf-8 
class Revista 
def initialize(titulo) 
Otitulo = titulo 
end 


def titulo 
Otitulo 
end 


def titulo formatado 
"Titulo: #{titulo}" 
end 
end 


mundo_j = Revista.new "MundoJ" 
p mundo_j.titulo_formatado # => Titulo: MundoJ 


No código acima, na chamada ao método titulo, o receiver é self. Mas quem 


é o self neste momento? 


# coding: utf-8 
class Revista 
def initialize(titulo) 
Otitulo = titulo 
end 


def titulo 
Otitulo 
end 


def titulo formatado 
puts self # => #<Revista:0x007f93aal8cd70> 
"Titulo: #{titulo}" 
end 
end 


mundo_j = Revista.new "MundoJ" 
p mundo_j.titulo_formatado # => Titulo: MundoJ 


O código puts self imprimiu queo self é o próprio objeto mundo_j, ou 
seja, o método titulo foi invocado no próprio objeto mundo. 5. 
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Podemos invocar o método titulo, especificando qual o receiver: 
self.titulo, mas isso só deixaria nosso código mais poluído, porque o 





self neste caso não faria diferença, já que implicitamente o método será invocado 
em self. 

Quando o receiver é explícito, o comportamento é bastante parecido, sendo a 
única e importante mudança que o self é alterado durante a chamada do método 
para representar o receiver explícito. Quando o Ruby termina a execução do método, 
o self volta a ter seu estado anterior. Por exemplo: 


# coding: utf-8 
class Revista 
def initialize(titulo) 
Otitulo = titulo 


end 

def titulo 
titulo upcase = @titulo.upcase 
"Titulo: #{titulo_upcase}" 

end 


end 


mundo_j = Revista.new "MundoJ" 
p mundo_j.titulo # => Titulo: MUNDOJ 


Quando invocamos o método upcase em uma String, entéoo self neste 
momento será o objeto String. Logo após a execução do upcase, o self volta 
a ser o objeto mundo 5. 


8.2 O IMPACTO DO SELF NA DEFINIÇÃO DE CLASSES 


Quando definimos classes em Ruby, self também é alterado para representar o 
objeto que guarda as informações da classe que estamos definindo. Isso acontece 
porque definir classes em Ruby, é como executar um outro código qualquer, onde 
criamos objetos e invocamos métodos. Para mostrar como isso funciona, vamos 
colocar um puts no meio da declaração da classe Revista: 


# coding: utf-8 
class Revista 
puts "0 self aqui é: #{self}" 
puts "O self aqui é do tipo: #{self.class}" 
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def initialize(titulo) 
Otitulo = titulo 


end 

def titulo 
titulo upcase = @titulo.upcase 
"Título: #{titulo_upcase}" 

end 


end 


Quando executamos este código, o resultado é: 


# => O self aqui é: Revista 
# => O self aqui é do tipo: Class 


Na definição de classes, o self é um objeto do tipo Class que guarda todas 
as informações da classe que estamos criando. Ele pode inclusive, guardar variáveis 


de instância: 


# coding: utf-8 
class Revista 


@id = 0 
def self.id 


@id += 1 
end 


def initialize(titulo) 
Otitulo = titulo 


end 

def titulo 
titulo upcase = @titulo.upcase 
"Título: #{titulo_upcase}" 

end 


end 


Há muita coisa diferente nesse código que ainda não vimos, então, vamos por 
partes e com bastante calma. 
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Definimos uma variável Gid com o valor 0 dentro do objeto self da defini- 
ção da classe Revista, e já sabemos que self neste momento é o objeto do tipo 
Class que guarda não só os métodos definidos na classe, mas também variáveis de 
instância que não são dos objetos Revista mas sim do objeto Class que guarda 
informações da classe Revista. Lembre-se que em Ruby tudo são objetos. 

Logo após, definimos um método id dentro de self, ou seja, um método 
dentro do objeto Class. Este método deve ser executado a partir da objeto Class 
que representa a classe Revista: 


p Revista.id # => 1 
p Revista.id # => 2 
p Revista.id # => 3 


p Revista.new('MundoJ').id 
# => NoMethodError: undefined method “id' for #<Revista:0x007fcb7c86dd60> 


Repare que o método não existe para instâncias do tipo Revista, mas apenas 
na classe Revista. Complicado essa parte, não? Vamos entender ela com mais 
detalhes na próxima seção, estudando os Singletons. 


8.3 SINGLETON CLASS E A ORDEM DA BUSCA DE MÉTODOS 


Em Ruby, quando invocamos um determinado método em um objeto, o interpreta- 
dor procura pelo método no objeto class que representa a classe do objeto onde o 
método foi invocado, por exemplo: 


mundo j = Revista.new "MundoJ" 
p mundo j.titulo É => Título: MUNDOJ 


O objeto do tipo Class que representa a classe Revista guarda referência 
para o método titulo e quando invocamos este método, o interpretador Ruby 
procura por ele no objeto Class. Tudo isso já sabíamos, mas a novidade agora é 
que o interpretador Ruby procura por este método em outro lugar primeiro: 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
linux = DVD.new "Linux for Dummies", 13.9, :sistemas operacionais 


def windows.desconto formatado 


"Desconto: #{@desconto * 100}%" 
end 
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windows.desconto formatado 
# => Desconto: 10.0% 


ão] 


linux.desconto formatado 


ao] 


# => NoMethodError: undefined method “desconto formatado! for "linux":DVD 


Quando invocamos o método desconto formatado no objeto windows, 
o Ruby define self como o objeto windows e então procura pelo método e o 
encontra. Mas porque quando invocamos o mesmo método no objeto linux ele 
não é encontrado. O método não foi definido para todos os objetos DvD? O Ruby 
faz alguma magia negra para definir o método desconto formatado apenas para 
o objeto windows? A resposta é não. Lembre-se que metaprogramação não é magia 
negra, consiste apenas em aprender a linguagem a fundo e saber usá-la a seu favor. 

Quando definimos o método desconto formatado no objeto windows, O 
Ruby cria uma nova classe e define o método dentro dela. Esta classe é anônima e é 
conhecida como Singleton class, metaclass ou eigenclass. Vamos seguir chamando-a 
de singleton class até o final do livro. 

A singleton class criada é definida como a class do objeto windows, e a 
superclass da singleton class é a classe DVD, conforme pode ser observado na 
imagem abaixo: 
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windows 
singleton class 


desconto formatado() 





Ao invocarmos algum outro método que não está definido na singleton class do 
objeto windows, o interpretador Ruby, primeiro irá procurar pelo método na sin- 
gleton class, caso não encontre, irá procurar na superclass Revista e provavel- 
mente o encontrará. 

Quando definimos o método ida na classe Revista, nós criamos o método na 
singleton class do objeto Class que representa as definições da classe Revista. 
Quando invocamos o método Revista.id,na verdade estamos invocando o mé- 
todo na singleton class. 

Após a definição, foi criada uma singleton class cuja superclass é Revista, 
conforme a imagem abaixo mostra: 
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mundo j 


Revista 


mundo j 
singleton class 






Revista 
singleton class 


Podemos agora invocar o método id no momento da criação de objetos do tipo 


Revista 


# coding: utf-8 
class Revista 


end 


@id 


def 


end 


def 


end 


def 


end 


def 


end 


= 0 
self.id 


@id += 1 


initialize (titulo) 
@id = self.class.id 
Otitulo = titulo 


id 
@id 


titulo 


titulo upcase = @titulo.upcase 
"Titulo: #{titulo_upcase}" 
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mundo j = Revista.new "MundoJ" 
p mundo j.id & => 1 


mundo ruby = Revista.new "MundoRuby" 
p mundo ruby.id # => 2 


Primeira definição que devemos nos lembrar, a variável de instância @id defi- 
nida no método initialize não é a mesma que foi definida na criação da classe. 
Elas estão em contextos ( self) diferentes, a primeira foi definida no contexto do 
objeto Class que representa as definições da classe Revista, já a segunda pertence 
ao objeto Revista que está sendo criado, portanto elas não conflitam. Exatamente 
por esse motivo, é impossível acessar a variável Gia da classe Revista em métodos 
de instâncias de Revista, por exemplo, dentro do método initialize. 

A mesma regra vale para os métodos id. O primeiro foi criado na singleton class 
do objeto Class que representa a classe Revista, o segundo foi definido para as 
instâncias de Revista que forem criadas. 

O valor da variável gia do método initialize é inicializado com o valor de 
retorno do método id definido na singleton class da classe Revista. Como o self 
no método initialize representa o objeto que está sendo criado, para acessar o 
método id da singleton class da classe Revista, invocamos self.class e em 
seguida o método id, que incrementa e retorna a variável @id. 


8.4 INDO MAIS A FUNDO: ACESSANDO A SINGLETON CLASS 


Nós aprendemos a definir métodos na singleton class de objetos do tipo DVD, mas 
também aprendemos a adicioná-los na singleton class do objeto Class que repre- 
senta a classe Revista. Existe outra sintaxe para fazermos as mesmas tarefas feitas 
anteriormente: 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 


class << windows 
def desconto formatado 
"Desconto: #{@desconto * 100}%" 
end 
end 
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p windows.desconto formatado 
# => Desconto: 10.0% 


Utilizando esta sintaxe, o objeto self passa a ser o objeto windows, fazendo 
com que o método desconto formatado seja adiciona apenas neste objeto. 

Podemos utilizar a mesma sintaxe ao definir métodos no contexto de um classe, 
por exemplo: 


class Revista 
@id = 0 


class << self 
def id 
@id += 1 
end 
end 
end 


p Revista.id # => 1 
p Revista.id # => 2 


Neste caso, o self dentro da singleton class é o próprio objeto do tipo Class 
que representa a classe Revista. Umas das vantagens de utilizar esta sintaxe é poder 
invocar métodos privados, já que eles não podem ser acessados através de um receiver 
explícito. Imagine que precisamos adicionar um método para retornar o valor atual 
da variável @id. Podemos implementar isso utilizando o método attr reader: 


class Revista 
@id = 0 


class << self 
attr reader :id 
end 
end 


Se utilizássemos a sintaxe antiga, faríamos: self.attr reader :id. Porém, 
o interpretador acusaria um erro, informando que método privados não podem ser 
invocados a partir deum self explícito. 

Eu particularmente, prefiro a sintaxe self.nome do metodo. Utilizo a sin- 
taxe class << objeto apenas em casos esporádicos como o exemplo que eu citei 
acima. [/box] 
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8.5 METAPROGRAMAÇÃO E AS DEFINIÇÕES DE UMA CLASSE 


Podemos utilizar o método attr reader para criar pares de métodos get e set 
que acessam as variáveis de instância dos objetos criados a partir da classe DVD, por 
exemplo: 


# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
%Q{ Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


Ao utilizarmos bibliotecas externas, nos deparamos com códigos que fazem cha- 
madas a métodos no momento da definição da classe. Por exemplo, a biblioteca 
Mongoid, que cria uma camada ORM para acessarmos dados em um MongoDB, 
possui um método field que serve para especificarmos quais campos serão mape- 
ados entre o objeto e um documento salvo no banco: 


class Document 
include Mongoid: :Document 
field :name, type: String 
end 


Estes métodos são sempre invocados no momento da definição da classe, e na 
maioria das vezes geram código por baixo dos panos. Nós também podemos criar 
métodos que serão utilizados na definição de classes, e que geram código automati- 
camente. Este é um dos poderes da metaprogramação, escrever código automatica- 
mente sem que seja necessária muita repetição. 

No capítulo anterior, nos criamos um Module que serve para formatar uma 
variável @valor da classe onde o módulo foi incluído. Em nossos exemplos, utili- 
zamos o módulo na classe Livro, mas também podemos utilizá-lo na classe DVD: 
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# coding: utf-8 
class DVD < Midia 
include FormatadorMoeda 


attr_reader :titulo 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


def to_s 
J Titulo: #{@titulo}, Valor: #{@valor} } 
end 
end 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_formatado # => R$ 98.9 


Agora precisamos que a variável @desconto também seja formatada. Podemos 
alterar o módulo FormatadorMoeda para resolver o problema: 


module FormatadorMoeda 
def valor formatado 
"R$ #{@valor}" 
end 


def valor com desconto formatado 
"R$ &(valor com desconto)" 
end 
end 


Pronto! Temos também um método valor com desconto formatado 
(que utilizou o método valor com desconto definido na classe Midia): 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
p windows.valor formatado & => R$ 98.9 
p windows.valor com desconto formatado # => R$ 89.01 


Mas temos um problema um pouco grave ao adotar a solução proposta acima. 
A cada “valor” de atributo ou método dos meus objetos que eu queira formatar adi- 
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cionado o prefixo “R$”, teremos que adicioná-lo no módulo FormatadorMoeda. 
Solução não muito elegante, concorda? Certo, você concordou :) . 

O que podemos utilizar é metaprogramação. Vamos criar um método 
formata moeda que servirá para definirmos quais variáveis de instância ou 
métodos devem ter um método similar que retorne o valor formatado, por 
exemplo: Se houver um método valor com desconto, existirá um simi- 
lar valor com desconto formatado, se houver uma variável de instância 
@valor, haverá um método valor formatado e assim por diante. 

Vamos colocar a mão na massa. O primeiro passo é definir o método 


formata moeda 


# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


def self.formata moeda 
def valor formatado 
"R$ #{@valor}" 
end 


def valor com desconto formatado 
"R$ t(valor com desconto)" 
end 
end 


formata moeda 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 
end 


O método formata moeda foi adicionado na singleton class do objeto da classe 
DVD. Isso significa que posso invocá-lo logo após sua definição sem explicitamente 
definir qual o receiver, pois o self neste caso é o objeto que representa a classe DVD. 

No momento que invocamos o método formata moeda, ele define os métodos 


valor formatadoe valor com desconto formatado para todos os objetos 
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DVD que forem criados. Mas isso não ajudou muita coisa, pois o que fizemos foi 
copiar e colar o código definido no módulo FormatadorMoeda. 

O que precisamos é definir automaticamente estes métodos. Vamos utilizar um 
método chamado define method, que recebe o nome do método que desejamos 
criar e um bloco que representa o corpo do método, ou seja, o conteúdo entre o def 
eo end. Lembrando que qualquer parâmetro definido no bloco torna-se parâmetro 
do método que está sendo criado. 

A primeira informação que precisamos passar na chamada do método 
formata moeda são as variáveis de instância que desejamos formatar e também 
quais os métodos. Na verdade estas informações serão passados na chamada do mé- 
todo, porque precisamos delas para saber quais serão os métodos que serão gerados 


automaticamente via define method. 


# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


def self.formata moeda(*variaveis e metodos) 
def valor formatado 
"R$ #{@valor}" 
end 


def valor com desconto formatado 
"R$ t(valor com desconto)" 
end 
end 


formata moeda :valor com desconto, :valor 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 
end 


Agora vamos utilizar o método define method para criar os método 


valor formatadoe valor com desconto formatado 
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# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


def self .formata_moeda(*variaveis_e_metodos) 
variaveis_e_metodos.each do |name| 
define_method("#{name}_formatado") do 
valor = 
respond_to?(name) ? send(name) : instance_variable_get("@#{name}") 
"R$ #{valor}" 
end 
end 
end 


formata_moeda :valor_com_desconto, :valor 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 
end 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_formatado # => R$ 98.9 
p windows.valor_com_desconto_formatado # => R$ 89.01 


Recebemos os valores que devem ser formatados em um Array contendo 
[:valor, :valor com desconto], sendo assim precisamos criar os método 
valor formatadoe valor com desconto formatado. Por isso iteramos o 
Array, para gerar um método para cada valor. 

O método define method recebe no primeiro argumento, cada uma dos valo- 
res do Array interpolado com formatado, e o segundo argumento é o bloco que 
define o corpo do método, onde definimos seu comportamento. Repare que o bloco 
não recebe nenhum parâmetro porque o método que estamos definindo não precisa. 
Lembre-se que se fosse necessário receber algum parâmetro no método, deveríamos 
explicitá-los no bloco. 

O segredo maior do nosso código está na busca pelo valor que deve ser for- 
matado. Um detalhe importante, invocamos os métodos respond to, send 
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e instance variable get dentro do corpo do método que estamos criando. 
Todos estes métodos são invocados no default receiver, que neste caso, é o objeto 
windows. O método define method está criando um método nas instância de 
DVD e não no objeto Class que representa a classe DVD. 

O método respond to que já havíamos visto, verifica se o objeto pos- 
sui um determinado método. Este método recebe um Symbol, se o objeto ti- 
ver o método o retorno é true, senão false. Em nosso exemplo, o pri- 
meiro item do Array é :valor com desconto, quando invocamos o método 
respond to? (:valor com desconto) o retorno é true, logo em seguida in- 
vocamos o método valor com desconto utilizando um outro método do core 
Ruby, chamado send. 

O método send recebe um Symbol que é o nome do método que desejamos 
invocar. Caso o método que vamos invocar exija argumentos em sua chamada, po- 
demos passá-los logo após o nome do método separando-os com ,: 


def qualquer metodo (qualquer argumento, outro argumento) 
p qualquer argumento, outro argumento 
end 


send(: qualquer metodo, 123, 321) # => 123, 321 


O segundo item do Array éo Symbol valor que é uma variável presente 
nos objetos do tipo DVD. Quando fazemos a verificação se o objeto DVD possui 
o método valor, o resultado é false, já que este método realmente não está 
definido. Neste caso, nós precisamos acessar o valor da variável @valor, porém, 
variáveis de instância são privadas. Podemos trapacear esta regra utilizando o mé- 
todo instance variable get passando o nome da variável com €,se a variável 
existir, seu valor será retornado. | Em ambos os casos, guardamos o valor em uma 
variável local chamada valor, que logo em seguida é interpolado com a String: 
R$. Para comprovar que os métodos realmente foram criados nos objetos DVD, po- 
demos utilizar o método methods que retorna um Array com todos os métodos 
disponíveis: 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
p windows.methods # => [..., :valor formatado, 
:valor com desconto formatado, ...] 


Esta técnica de metaprogramação é muito utilizada em frameworks como Rails, 
por exemplo. O comportamento que utilizamos é bem parecido com o comporta- 
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mento utilizado no método attr accessor que cria novos métodos para acessar- 
mos variáveis de instância de objetos de uma determinada classe. 


Compartilhando o método formata moeda 


A implementação do método formata moeda utilizado para criar métodos 
que formatam valores de atributos ou métodos criados anteriormente estão restritos 
para uso dentro a classe DVD. Se quisermos utilizá-lo dentro das classes Livro e 
CD, podemos movê-lo para dentro da classe Midia já que esta é a superclasse de 
Livroe CD. 


Porém se quisermos utilizá-lo dentro da classe Revista, teríamos que fazer 
com que ela também estendesse Midia, uma opção que não faz muito sentido em 
nosso modelo de negócio. Além de não fazer sentido métodos que formatam valores 
serem definidos dentro da classe Midia, pois isso foge de suas responsabilidades. 


O melhor caminho é utilizar um módulo: 


module FormatadorMoeda 
def formata moeda(*variaveis e metodos) 
variaveis e metodos.each do |name| 
define method("t(namej formatado") do 
valor = 
respond to? (name) ? send(name) : instance variable get ("@#{name}") 
"R$ #{valor}" 
end 
end 
end 
end 


E utilizar dentro das classes que desejamos este comportamento. Utilizando o 
extend na definição da classe, os métodos definidos no módulo serão incluídos 
como “métodos de classe”, ou seja, serão incluídos no objeto Class que representa 
as definições da classe DVD, podendo ser utilizados exatamente da mesma maneira 
que eram quando definimos o método diretamente na definição da classe: 


# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


extend FormatadorMoeda 
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formata moeda :valor com desconto, :valor 


def initialize(titulo, valor, categoria) 
super () 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 
end 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas_operacionais 
p windows.valor_formatado # => R$ 98.9 
p windows.valor_com_desconto_formatado # => R$ 89.01 


Varags em Ruby 


O método formata moeda recebe um Array contendo símbolos que repre- 
sentam os nomes das variáveis e métodos para os quais desejamos criar métodos 
formatadores. Existe uma maneira mais elegante de criarmos métodos que preci- 
sam receber argumentos com número variável em Ruby: 


# coding: utf-8 
class DVD < Midia 
attr_reader :titulo 


# adicionado o caractere * antes do nome do argumento 
# define que este argumento recebe N valores 
# separados por virgula 


def self.formata moeda(*variaveis e metodos) 
variaveis e metodos.each do |name| 
define method("t(namej formatado") do 
valor = 
respond_to?(name) ? send(name) : instance variable get ("@#{name}") 
"R$ #{valor}" 
end 
end 
end 


formata moeda :valor com desconto, :valor 
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# outros metodos 
end 


Basta adicionar o caractere » antes do nome do argumento que receberá varios 
valores. Dentro do método o argumento é um Array, que contém os vários valores 
passados. Podemos adicionar apenas um argumento que receberá vários valores, 
porque seria impossível para o interpretador Ruby atribuir os valores corretamente 
se tivéssemos dois argumentos deste tipo. 


Definindo métodos de classe e de instância no módulo 


Caso seja necessário definir métodos de instância e de classe dentro do mesmo 
módulo, existe um técnica muito utilizada em frameworks como Rails. Esta técnica 
faz uso de um hook method do Ruby chamado included, que é chamado automa- 
ticamente quando incluímos um módulo em uma classe. Neste método recebemos 
um objeto Class que representa a classe que está incluindo o módulo. 


Mesmo assim é necessário separar os métodos de instância dos métodos de 
classe. Geralmente fazemos isso utilizando um nested module que contém apenas 
os métodos de classe, deixando os métodos de instância na definição do próprio 
módulo, por exemplo: 


module FormatadorMoeda 
def metodo de instancia 
"um metodo de instancia qualquer" 
end 


# Módulo que guarda os métodos de classe 
module ClassMethods 
def formata moeda(*variaveis e metodos) 
variaveis e metodos.each do |name| 
define method("t(name) formatado") do 
valor = respond to? (name) ? 
send (name) 
instance variable get ("@#{name}") 
"R$ #{valor}" 
end 
end 
end 
end 
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end 


# hook method que é executado quando incluímos o módulo 
# dentro de alguma classe, recebendo no argumento 

# classe que incluiu modulo o objeto hhClasshh que 

# representa a classe que incluiu o módulo 


def self. included(classe que incluiu modulo) 
classe que incluiu modulo.extend ClassMethods 
end 


# coding: utf-8 
class DVD < Midia 


end 


windows = DVD.new "Windows 7 for Dummies", 98.9, 


attr_reader :titulo 
include FormatadorMoeda 
formata_moeda :valor_com_desconto, :valor 


def initialize(titulo, valor, categoria) 
super 
Otitulo = titulo 
@valor = valor 
@categoria = categoria 
end 


p windows.valor_formatado # => R$ 98.9 


p windows.valor_com_desconto_formatado # => R$ 89.01 


p windows.metodo_de_instancia # => "um metodo de instancia qualquer" 


Utilizando esta técnica, podemos criar módulos que possuem métodos que serão 


adicionados nas instâncias de DVD e também métodos que podem ser utilizados na 


definição da classe. 


8.6 CRIANDO UM FRAMEWORK PARA PERSISTIR OBJETOS 


EM ARQUIVOS 


A principal camada de persistência difundida na comunidade Ruby é conhecida 


como ActiveRecord, a implementação de um design pattern de mesmo nome que 
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visa persistir dados de um objeto através de interfaces públicas definidas no próprio 
objeto. Essa interface geralmente possui os métodos create, update, finde 
delete. 

Atualmente o código da classe BancoDeArquivos recebe um objeto do tipo 
Livro eo salva em um arquivo chamado livros.yml. A partir de agora faremos 
uma refatoração, onde a classe deixará de existir e os métodos para inserir, atualizar, 
buscar e remover um objeto Livro do banco de arquivos serão feitos através de uma 
interface no próprio objeto. 

Vamos começar fazendo o código apenas na classe Revista, que foi refatorada 
para ter apenas um atributo titulo eum valor: 


class Revista 
attr reader :titulo, :id 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
end 
end 


O próximo passo será definir um método save que fará uma implementação 
dupla, ele será responsável por criar um arquivo cujo nome será um id automático 
gerado para cada objeto Revista e gravar o conteúdo do objeto dentro deste ar- 
quivo. Também será responsável por atualizar o conteúdo do arquivo caso o mesmo 
já exista. 

Dentre estes passos, o primeiro é criar um campo id e atribuir um valor auto- 


mático a ele: 


class Revista 
attr reader :titulo, :id 


def initialize(titulo, valor) 

Otitulo = titulo 

@valor = valor 

@id = self.class.next id # Atribui um id ao objeto Revista 
end 


private 


def self.next id 
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Dir.glob("db/revistas/*.yml").size + 1 
end 
end 


Criamos um método de classe (next. id) que gera o próximo id para o objeto 
que está sendo criado. Sua implementação é bem simples, ele utiliza a classe Dir 
da API File do Ruby, para contar quantos arquivos .ym1 existem dentro da pasta 
db/revistas onde estão localizados os arquivos referentes aos objetos salvos em 
disco. Somando o valor 1 a quantidade de arquivos sabemos qual é o id do próximo 
arquivo gerado. Definimos também um método para acessarmos o id do objeto 
que foi criado. 

Agora basta criarmos o método save que será responsável por guardar o con- 
teúdo do objeto serializado dentro de um arquivo cujo nome será o id do objeto: 


class Revista 
attr reader :titulo, :id 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
end 


def save 
File.open("db/revistas/#{@id}.yml", "w") do |filel 
file.puts serialize 
end 
end 


private 


def serialize 
YAML.dump self 
end 


def self .next_id 
Dir.glob("db/revistas/*.yml").size + 1 
end 
end 


A implementação do método save abre um arquivo na pasta 
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db/revistas/f[(id do objeto).yml (cria a pasta db/revistas na 
raiz do projeto) em modo de escrita e imprime dentro dele o conteúdo do próprio 
objeto ( self) serializado em yaml. Podemos comprovar que o comportamento foi 
implementado com sucesso executando o código abaixo: 


mundo j = Revista.new "Mundo J", 10.9 
mundo j.save 


Ao abrirmos o arquivo db/revistas/1.yml veremos o seguinte conteúdo: 


--- !ruby/object:Revista 


valor: 10.9 
titulo: Mundo J 
id: À 


Exatamente o conteúdo que existia no objeto mundo. 5. 

O método save também será responsável por salvar as atualizações feitas no 
objeto. Felizmente não será necessário alterar nenhuma linha de código no método 
já que quando abrimos o arquivo utilizando o modo w, qualquer impressão feita 
dentro do mesmo substitui o conteúdo existente pelo novo. Porém, para testar que 
a atualização está funcionando, precisamos permitir que os dados do objeto possam 
ser alterados. Vamos fazer com que o valor possa ser alterado adicionando um 
método de escrita: 


class Revista 
attr reader :titulo, :id 
attr accessor :valor # permite escrita no atributo valor 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
end 


def save 
File.open("db/revistas/#{@id}.yml", "w") do |filel 
file.puts serialize 
end 
end 


private 
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def serialize 
YAML.dump self 
end 


def self.next_id 
Dir.glob("db/revistas/*.yml").size + 1 
end 
end 


Agora vamos alterar o valor de um objeto Revista e salvá-lo para verificar 
que as alterações serão refletidas no arquivo correspondente: 


mundo j = Revista.new "Mundo J", 10.9 
mundo j.save 


mundo j.valor = 12.9 
mundo j.save 


Ao abrirmos o arquivo db/revistas/1.yml, podemos ver que o conteúdo 
realmente foi alterado como esperávamos: 


--- !ruby/object:Revista 


valor: 12.9 
titulo: Mundo J 
id: 1 


Buscando objetos 


Com isso completamos duas operações principais do CRUD (Create, Retrieve, 
Update, Delete): Create e Update. Vamos agora implementar o método que recebe 
um id, busca pelo arquivo correspondente, e retorna o objeto deserializado: 


class Revista 
attr reader :titulo, :id 
attr accessor :valor 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
end 
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def save 
File.open("db/revistas/#{@id}.yml", "w") do |filel 
file.puts serialize 
end 
end 


def self.find(id) 
YAML.load File.open("db/revistas/#{id}.yml", "r") 
end 


private 


def serialize 
YAML.dump self 
end 


def self .next_id 
Dir.glob("db/revistas/*.yml").size + 1 
end 
end 


O código não esta muito diferente do encontrado na classe BancoDeArquivos 
implementada no capitulo 6. A diferença principal é que criamos o método find 
como método do objeto Class referente a classe Revista. Isso faz bastante sen- 
tido, já que não termos a instância do objeto que estamos procurando, nós na verdade 
queremos criá-la a partir do conteúdo do arquivo. Em frameworks como Active Re- 
cord esse tipo de comportamento é comum. 

Outra diferença é que agora nós guardamos apenas 1 objeto serializado por ar- 
quivo, por isso, no momento da leitura precisamos apenas utilizar o método open 
da classe File e passar o seu resultado para ser deserializado pela API de YAML. 

Invocando o método find passando com argumento um id cujo arquivo exista 
em disco, o objeto existente será deserializado e retornado: 


mundo j = Revista.find 1 
p mundo j.valor # => 12.9 


Como vimos, caso ele exista ele um objeto do tipo Revista é retornado para o 
cliente do método find. Mas a pergunta que fica é: Quando o arquivo for removido 
ou não existir em disco, o que o método find retornará? 
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A decisão de como implementar este comportamento é bem extensa e causa 
grandes discussões, uns vão preferir o comportamento que já existe, que consiste 
em retornar nil caso o arquivo referente ao id não seja encontrado. 

Retornar nil, na minha opinião, não funciona muito bem, afinal não encon- 
trar o arquivo que contém os dados do objeto que está sendo procurado é um erro. 
Quando retornamos nil não estamos expressando o que realmente aconteceu de 
fato e com isso o cliente do método não sabe como realmente tratar a possível falha. 

Alguns desenvolvedores tem o péssimo hábito de inventar códigos de erro, que 
em geral são número aleatórios de 1 à 1000, para expressar um erro que aconteceu no 
sistema. Todos nós aqui já nos deparamos com coisas do gênero em algum momento 
de nossas vidas, o que convenhamos não é nada legal, já que o número, exceto se for 
decorado, não representa muita informação. Portanto, nunca faça isso, no dia que 
fizer provavelmente você se lembrara de mim e terá que correr 30 km em uma esteira 
no sol do meio dia. 

Outras preferem retornar exceções, o meu caso, avisando ao cliente do método 
find que ele não deveria invocar o método passando um id que não existe mais. 
Esse comportamento também é seguido pelo Active Record, que retorna uma exce- 
ção do tipo Document Not Found. Exceções na verdade são objetos que encapsulam 
o erro. O cliente do método tem a opção de se recuperar do possível erro ou ela será 
propagada até o final da stack de execução, estourando um erro para o usuário, pro- 
vavelmente. 

O método fina, como foi dito anteriormente, precisa retornar uma exceção 
caso o arquivo referente ao id passado não seja encontrado. Porém, exceções são 
classes, e precisam ser definidas em algum momento. O Ruby possui uma grande 
hierarquia de exceções que podem ser vistas na figura 8.1, e você verá que essa hie- 
rarquia nos ajuda muito no momento de criarmos código para tratar as exceções. 


8.7 GERENCIANDO EXCEÇÕES E ERROS 


Geralmente quando precisamos disparar exceções, criamos classes que se- 








jam filhas de StandardError, uma subclasse de Exception. A classe 
StandardError é a superclasse da maioria das exceções que nos deparamos até 








agora: NoMethodError, por exemplo. No caso do método find vamos retorna 
uma exceção própria que chamaremos de DocumentNotFound, que deve ser adi- 


cionada no arquivo 1ib/document not. found.rb: 
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class DocumentNotFound < StandardError 
end 


Agora, basta dispararmos esta exceção customizada quando o arquivo não exis- 
tir: 


# coding: utf-8 
class Revista 
def self.find(id) 
raise DocumentNotFound, 
"Arquivo db/revistas/#{id} não encontrado.", caller 
unless File.exists?("db/revistas/#{id}.ym1") 
YAML.load File.open("db/revistas/#{id}.yml", "r") 
end 
end 


Nós disparamos exceções utilizando um método do Kernel chamado raise, 
que neste caso é executado apenas se o método File.exists? retornar false, 
ou seja, caso o arquivo não exista em disco. O método raise interrompe o fluxo 
de execução do método, por isso, seo método raise for invocado, existe a garantia 
que o código YAML.load # ... não será executado. 

A forma que utilizamos o método raise dispara uma exceção do tipo 
DocumentNotFound, com uma mensagem de erro que representa uma explicação 
do erro retornado e por último utilizamos mais um método do Kernel: caller, 
que retorna a Stack Trace que informa mais organizadamente onde o erro aconteceu 
e onde poderia ter sido tratado. 





RAISE E SUAS VARIAÇÕES 


Podemos invocar o método raise passando apenas um String 
que representa a mensagem de erro que será inserida na exceção que está 
sendo lançada: 


raise "Aconteceu um erro qualquer" 





Neste caso o tipo de exceção disparada será: RuntimeError. 
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EXCECOES MAIS INFORMATIVAS 


Lembre-se que as exceções são objetos normais, e possuem um de- 
finição formal escrita em uma classe. Você, assim como em qualquer 
outro objeto, pode adicionar métodos, inclusive definir seu próprio 
initialize, que receberá os argumentos desejados: 


class DocumentNotFound < StandardError 
def initialize(mensagem) 
@mensagem = mensagem 
end 


def mensagem formatada 
"__ #{@mensagem}" 
end 


end 











Como tratar os erros 


O que acontecerá quando invocarmos o método find passando como argu- 
mento o id de um arquivo que não existe? Uma exceção será lançada, e o seguinte 
erro será impresso: 


Revista.find 42 # => DocumentNotFound: Arquivo db/revistas/42 
não encontrado. 


E também será impressa a stack trace com as chamadas e onde realmente o erro 
estourou. O que não sabemos ainda é como lidar com este erro e não interromper o 
fluxo de execução do nosso sistema. Vamos adicionar um tratador de exceções, ou 
melhor, um exception handler: 


begin 

Revista.find 42 
rescue 

p "O objeto que estava procurando não foi encontrado." 
end 


# => O objeto que estava procurando não foi encontrado. 
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Todo o conteúdo existente que está dentro do begin, está protegido pelo excep- 


tion handler rescue que foi definido. Quando não passamos nenhum argumento 





parao rescue, ele trata exceções tipo ou de subtipos de StandardError, ou seja, 


seocódigo Revista.find 42 


retornar qualquer exceção destes tipos, o p que co- 


locamos será executado. Caso você queira restringir o poder de tratamento de erro 


do rescue, você pode especific 


begin 

Revista.find 42 
rescue DocumentNotFound 

p "O objeto que estava 
end 


begin 
Revista.find 42 


ar a exceção ou exceções que deseja tratar: 


procurando não foi encontrado." 


rescue DocumentNotFound, OutraExcecaoAqui 


p "O objeto que estava procurando não foi encontrado." 


end 


Você pode também receber em uma variável local, o objeto que representa o erro 


que aconteceu: 


begin 
Revista.find 42 

rescue DocumentNotFound => 
p erro 

end 


Vários rescue 


erro 


Você pode definir vários exception handlers após um begin: 


begin Revista.find 42 rescue DocumentNotFound p “Documento nao encon- 


trado” rescue OutraExcecao Aqui p “Outra excecao” end 


Bastante parecido com um switch/case. Caso a exceção bata com o primeiro 


rescue a mensagem “Documento nao encontrado” será impresso, caso não, o match 


será feito com a exceção Out ral 
cao” será impressa. 


162 





ExcecaoAqui, se bater, a mensagem “Outra exce- 


Casa do Código Capítulo 8. Metaprogramação e seus segredos 





Operações obrigatórias com o ensure 


Algumas vezes é importante que algum processo seja feito caso o código seja 
executado com sucesso ou caso alguma exceção seja tratada. O exemplo mais clássico 
e quando estamos lendo um arquivo utilizando a classe File, e precisamos garantir 
que o arquivo é fechado após a execução do código. 

Para garantir este comportamento utilizamos a cláusula ensure logo após a 
cláusula rescue, onde definimos um pedaço de código que será executado se o có- 
digo dentro do begin executar normalmente, se tratarmos uma exceção utilizando 
o rescue ou até mesmo se acontecer alguma exceção que não havia sido prevista: 


file = File.open("/tmp/file") 
begin 
p file.read 
rescue 
p "tratando erro" 
ensure 
file.close 
end 


retry 


Outras vezes é necessário retentar a execução de uma tarefa definida dentro de 
um bloco begin end, por exemplo, tentar inserir um registro no banco de dados, 
caso o banco esteja indisponível, podemos tentar novamente. É possível alcançar 
este objetivo utilizando o método retry dentro da cláusula rescue: 


begin 

db.collection("people") . insert (fnome: "Lucas Souza") 
rescue 

p "Conexao está indisponível" 

retry # executa o bloco begin/end novamente 
end 


Caso alguma exceção aconteça, a tentativa de inserção no banco de dados será 
executada novamente. É muito importante salientar que o código acima pode se 
tornar um loop infinito, caso o banco não esteja disponível em nenhum momento. 
O ideal é criar flags que garantam um número mínimo de tentativas ou ter realmente 
certeza do que está fazendo. 
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8.8 A EXCLUSÃO DE DADOS IMPLEMENTADA COM META- 
PROGRAMAÇÃO 


A última operação que falta para completarmos o CRUD da classe Revista é a 
exclusão de objetos deste tipo. A implementação do método destroy será bastante 
simples, porém, causará alguns efeitos colaterais. Vamos ao código: 


# coding: utf-8 
require "FileUtils" 


class Revista 
attr_reader :titulo, :id 
attr_accessor :valor 


# initialize 
# save 
# destroy 


def destroy 
FileUtils.rm "db/revistas/#{@id}.ym1" 
end 


# métodos privados 
end 


Utilizamos a classe FileUtils, que possui uma série de métodos utilitarios 
para lidar com arquivos. Lembre-se que é necessário fazer um require desta classe 
para poder utilizá-la. A implementação do método dest roy é bem simples, quando 
invocado uma tentativa para excluir o arquivo cujo nome é a variável de instância 
@idyml é feita utilizando o método rm da classe FileUtils. 


O comportamento pode ser testado executando o código abaixo: 


mundo j = Revista.find 1 
mundo j.destroy 


Revista.find 1 


# => DocumentNotFound: Arquivo db/revistas/1 não encontrado 


164 


Casa do Código Capítulo 8. Metaprogramação e seus segredos 





Repare que na segunda vez que tentamos buscar um objeto Revista através 
do método finda, uma exceção é disparada garantindo que o objeto realmente foi 
excluído quando invocamos o método destroy. 

Mas o que acontece caso o método destroy seja invocado duas vezes em 
sequência? 


mundo j = Revista.find 1 

mundo j.destroy 

mundo j.destroy # => Errno: :ENOENT: No such file or 
directory - db/revistas/1.yml 


Na segunda tentativa o arquivo já não existe mais em disco, por este motivo a 
exceção No such file or directory foi disparada. Porém, não faz sentido 
essa exceção ser disparada quando um usuário está invocando o método destroy, 
que como o próprio nome diz, destrói o objeto em questão e não diz nada sobre lidar 
com arquivos em disco, toda está lógica está encapsulada dentro do método e os seus 
detalhes não devem ser expostos para os clientes da API. 


Para contornar este problema, vamos adicionar uma flag chamada destroyed 
que será inicializada com o valor false, e que terá seu valor alterado para true 
na primeira chamada ao método destroy: 


# coding: utf-8 
require "FileUtils" 


class Revista 
attr_reader :titulo, :id, :destroyed 
attr_accessor :valor 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
@destroyed = false 

end 


def destroy 
unless @destroyed 
@destroyed = true 
FileUtils.rm "db/revistas/#{@id}.ym1" 
end 
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end 
end 


Ao tentarmos invocar o método destroy por duas vezes, a segunda chamada 
não dispara nenhuma exceção e a variável @dest royed possui o valor true: 


mundo j = Revista.find 1 
mundo j.destroy 

mundo j.destroy & => nil 

p mundo j.destroyed # => true 


Mas como nem tudo é perfeito, ainda existe um problema em nosso método 
destroy. Caso algum objeto seja criado diretamente pelo método new, o va- 
lor da variável @destroyed será false, sendo assim possível invocar o método 
destroy. O problema é que o objeto acabou de ser criado e com certeza ainda não 
existe um arquivo que guarde seus valores. Ao invocarmos o método caímos no 


mesmo problema anterior: 


mundo j = Revista.new "Mundo Java", 10.9 
mundo j.destroy # => Errno::ENOENT: No such file or directory 


Podemos resolver este problema adicionando uma outra flag que será responsá- 
vel por guardar a informação se o objeto é um novo registro ou não, por isso, vamos 
chamá-la de Gnew record. Esta flag será inicializada com true e precisa ter seu 
valor alterado para false quando o objeto for salvo através do método save: 


# coding: utf-8 
require "FileUtils" 


class Revista 
attr_reader :titulo, :id, :destroyed, :new_record 
attr_accessor :valor 


def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
@destroyed = false 
Qnew record = true 

end 
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def save 
Qnew record = false # seta objeto como registro existente 


File.open("db/revistas/#{@id}.yml", "w") do |filel 
file.puts serialize 
end 
end 


def destroy 
# verificar se o objeto nao foi removido anteriormente 
# e se o objeto nao é um novo registro 
unless @destroyed or @new_record 
@destroyed = true 
FileUtils.rm "db/revistas/#{@id}.yml" 
end 
end 
end 


Agora no momento que criarmos um objeto diretamente pelo método new e 
tentarmos removê-lo, nada será executado: 


mundo j = Revista.new "Mundo Java", 10.90 
mundo j.destroy # => nil 


Caso o objeto seja salvo antes de ser removido, o método dest roy é executado 
normalmente: 


# cria e salva objeto revista 
mundo_j = Revista.new "Mundo Java" 
mundo_j.save 

mundo_j.destroy 


# verifica que o objeto ja nao existe mais 
Revista.find 1 # => DocumentNotFound 


Mas vocé deve estar se perguntando se isso nao causaria problemas na execu- 
ção do método find, pois, aparentemente o método YAML. load ao deserializar o 
conteúdo do arquivo executa o método initialize, certo? Errado. O processo 
de deserialização não executa o método initialize, ele apenas recupera os va- 
lores salvos em disco, diretamente para as variáveis de instância. Por este motivo, 
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quando executamos o método find, o objeto retornado possui a variável de instan- 
cia @new_recordcom ovalor false, já que antes de salvar o objeto, nós definimos 
o valor desta variável para false: 


mundo j = Revista.find 1 
mundo j.new record # => false 


Código com muitas responsabilidades 


O código da classe Revista possui muitas responsabilidades, além de guardar 
todos os atributos da classe, os métodos responsáveis por refletir o estado do ob- 
jeto no seu arquivo em disco estão todos definidos na própria classe. Além disso, se 
quisermos aproveitar estes métodos em outras classes, teríamos que duplicar o có- 
digo, ferindo o princípio do DRY (Don't Repeat Yourself) e tendo muito trabalho no 
momento que alterar algum destes comportamentos for necessário. 

Podemos isolar o código responsável por lidar com arquivos em uma classe, e 
utilizar herança para reaproveitar os comportamentos definidos. Porém, se no fu- 
turo existir a necessidade de utilizar herança para um propósito melhor, não pode- 
mos herdar de duas classes, neste caso seria necessário uma grande refatoração para 
suportar esta mudança. 

A melhor solução neste cenário é utilizar os mixings para compartilhar compor- 
tamentos, incluindo-os nas classes que desejarmos. Vamos começar a nossa refato- 
ração seguindo baby steps, definindo primeiro um módulo com os métodos save, 
destroy e find de maneira que todos os códigos que utilizam a classe Revista 
continuem funcionando: 


# coding: utf-8 
require "FileUtils" 


module ActiveFile 
def save 
@new_record = false 


File.open("db/revistas/#{@id}.yml", "w") do |filel 
file.puts serialize 
end 


end 


def destroy 
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unless @destroyed or Qnew record 
@destroyed = true 
FileUtils.rm "db/revistas/#{@id}.yml" 
end 
end 


module ClassMethods 
def find(id) 
raise DocumentNotFound, 
"Arquivo db/revistas/#{id} nao encontrado.", caller 
unless File.exists?("db/revistas/#{id}.ym1") 
YAML.load File.open("db/revistas/#{id}.yml", "r") 
end 


def next_id 
Dir.glob("db/revistas/*.yml").size + 1 
end 
end 


def self.included (base) 
base.extend ClassMethods 
end 


private 


def serialize 
YAML.dump self 
end 
end 





Lembre-se de criar o módulo acima dentro do arquivo lib/active file.rb 





e executar o require do mesmo dentro do arquivo lib/loja virtual.rb. 
Agora, podemos utilizar o módulo ActiveFile e remover boa parte do código 
que estava sendo definido na classe Revista: 


class Revista 
attr reader :titulo, :id, :destroyed, :new record 
attr accessor :valor 


include ActiveFile 
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def initialize(titulo, valor) 
Otitulo = titulo 
@valor = valor 
@id = self.class.next_id 
@destroyed = false 
Qnew record = true 

end 

end 


O código da classe Revista ficou bem mais conciso e enxuto. Mas o método 
initialize ainda possui detalhes em sua implementação que são necessários para 
que o módulo Act iveFile funcione corretamente, por exemplo, a criação as variá- 
veis Gid, new recorde @destroyed. Com esta dependência de código, todas 
as classes que utilizarem o módulo ActiveFrile terão que definir exatamente as 
mesmas variáveis. A melhor maneira de resolver este problema é imitar frameworks, 
como ActiveRecorde Mongoid, definindo o método initialize dentro do 
mixing e controlando a criação de variáveis através de métodos de classe. 


Vamos tomar como exemplo um código utilizando Mongoid: 


class Revista 
include Mongoid::Document 


field :titulo, type: String 
end 


mundo j = Revista.new titulo: "MundoJ" 


A chamada ao método field define que os objetos do tipo Revista terão 
uma propriedade titulo, cujo valor é do tipo String. Vamos implementar nossa 
solução de maneira bem parecida, exceto pelo tipo, que no momento não é tão im- 
portante. Nosso primeiro passo será criar o método field: 


module ActiveFile 
# outros metodos 


module ClassMethods 
# metodo find 


# metodo next_id 
def field(name) 
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Ofields ||= [] 
@fields << name 
end 
end 


def self. included (base) 
base .extend ClassMethods 
end 
end 


O método é responsável apenas por guardar em um Array chamado @fields 
quais serão os atributos dos objetos que incluírem o módulo ActiveFile. 


Utilizando class eval para ajudar na definição da classe 


Além de guardar quais serão os atributos que formarão o objeto a ser salvo em 
arquivo, o método field cria os métodos acessores: get e set para cada um 
dos fields definidos. A variável self dentro do método field é a instância 
de Class referente a classe que está incluindo o módulo, em nosso caso, a classe 
Revista 

Para definir métodos acessores para um determinado field, podemos invocar 
o método attr acessor passando a variável name: 


module ActiveFile 
module ClassMethods 
def field(name) 
@fields ||= 0 
Ofields << name 


self.attr_acessor name 
end 
end 


def self.included(base) 
base.extend ClassMethods 
end 
end 


Entretanto esse código não funciona, porque o método attr acessor é pri- 
vado e não pode ser invocado com um receiver explícito. A solução pode ser a uti- 
lização do método send, que não diferencia se estamos invocando um método 
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private, protected ou public. Mas vamos aprender uma outra maneira de 
definir métodos de instância, desta vez utilizando metaprogramação. 

O método class eval da classe Object quando utilizado permite que um 
bloco de código seja executado como se o mesmo estivesse escrito na definição da 
classe. Os códigos abaixo possuem o mesmo efeito: 


class String 
def plural 
"H{self}s" 
end 
end 


p "cachorro".plural # cachorros 
String.class_eval do 
def plural 
"#{self}s" 
end 
end 


p "cachorro".plural # cachorros 


Ambos definem o método plural para instâncias de St ring, ou seja, ambos 
abrem a classe String e definem um método chamado plural. 
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INSTANCE EVAL 


O instance eval também pertence a classe Object e serve para 
executarmos um bloco de código. Porém, a diferença principal entre ele 
e o método class eval é que os método definidos dentro do bloco 
passado ao instance eval são incluídos na singleton class de self. 
Desta forma, ao invocarmos o método instance eval em uma ins- 
tância Class referente a classe String, os métodos definidos se tor- 


narão métodos de classe: 


String.instance eval do 
def metodo de classe 
"Isso eh um metodo de classe" 
end 
end 


# Isso eh um metodo de classe 
p String.metodo_de_classe 











Utilizando o método class_eval é possível definirmos os métodos necessá- 
rios para acessar o valor de um determinado field: 


module ActiveFile 
module ClassMethods 
def field(name) 
@fields Il= 0 
@fields << name 


get = KQ( 
def #{name} 
@#{name} 
end 


set = 4%Q{ 
def #{name}=(valor) 
@#{name}=valor 
end 


173 


8.8. A exclusão de dados implementada com metaprogramação 


Casa do Código 





self.class eval get 
self.class eval set 
end 
end 


def self. included (base) 
base .extend ClassMethods 
end 
end 


Nas variávellocais get e set definimos duas String, que possuem o conteúdo 


exato dos métodos criados automaticamente pelo método attr acessor. Após 


definir estas duas variáveis, cada uma delas é passada ao método class eval que 


fazo evaluate e executa o resultado como um código Ruby qualquer. 


O segundo passo da nossa refatoração é definir um método initialize ge- 


nérico para todos os objetos que incluírem o módulo ActiveFile. Neste método 


definiremos os valores das variáveis Gia, Enew recorde @destroyed: 


module ActiveFile 
def included (base) 
base .extend ClassMethods 
base.class eval do 
attr reader :id, :destroyed, 


def initialize 
@id = self.class.next id 
@destroyed = false 
QOnew record = true 

end 

end 
end 
end 


«new record 


O método initialize será definido na classe que inclui o módulo, quando o 


hook method included for executado. A implementação do método initialize 


está parcialmente feita, mas já permite que o método initialize seja removido 


da classe Revista. Além disso podemos definir os fields da classe utilizando o 


método field que cria as variáveis de instância e os métodos para acessá-las: 
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class Revista 
include ActiveFile 


field :titulo 
field :valor 
end 


revista = Revista.new 
p revista.new record # => true 
p revista.id # => quantidade de revistas + 1 


revista.titulo = "Veja" 
revista.valor = 10.90 
revista.save 


Todas as operações que fazíamos anteriormente, continuam funcionando da 
mesma maneira. A única restrição é que antes era possível inicializar os objetos 
passando os valores dos atributos através da chamada ao método new. Entramos 
na terceira parte da refatoração, que possibilitará a inicialização das variáveis de ins- 
tância. 


Simulando named parameters 


Named parameters é a capacidade de invocar funções ou métodos que recebem 
os valores dos atributos não por sua ordem, mas seguindo o nome de cada um deles. 
Em linguagens sem esta característica, é necessário seguir a ordem de definição dos 
parâmetros do método, por exemplo: 


def metodo (primeiro parametro, segundo parametro) 
p primeiro parametro, segundo parametro 
end 


metodo 10, "segundo" # => 10, "segundo" 
metodo "segundo", 10 # => "segundo", 10 


Como podemos ver, a ordem realmente é importante. Outra desvantagem é que 
não fica claro o que representa cada valor que passamos na chamada do método, a 
única maneira de descobrir estas informações é olhando o código fonte, o que nem 
sempre é possível. Ao utilizar named parameters podemos definir o valor de cada 
atributo na chamada do método: 
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def metodo(primeiro parametro: 1, segundo parametro: 2) 
p primeiro parametro, segundo parametro 
end 


metodo primeiro parametro: 10, segundo parametro: "segundo" 
# => 10, "segundo" 


metodo segundo_parametro: "segundo", primeiro_parametro: 10 
# => 10, "segundo" 


O código acima foi escrito em Ruby, porém, só irá funcionar na versão 2.0 que 
tem previsão de release final para fevereiro de 2013. Repare que não foi necessário se- 
guir a ordem de definição dos parâmetros do método, podemos passá-los na ordem 
que desejamos. No Ruby 1.9 e versões anteriores é possível simular o comportamento 
dos named parameters utilizando Hash: 


def metodo (parametros) 
p parametros [:primeiro parametro], parametros [: segundo parametro] 
end 


metodo primeiro parametro: 10, segundo parametro: "segundo" 
# => 10, "segundo" 


metodo segundo_parametro: "segundo", primeiro_parametro: 10 
# => 10, "segundo" 


Recebemos um Hash e ao invocarmos o método, as chaves são o “nome” dos 
atributos e os valores são, obviamente, os valores dos atributos relacionados a cada 
chave. É muito comum encontrarmos códigos escritos em Ruby que utilizam Hash 
para simular os named parameters, por isso, utilizaremos esta técnica para passar os 
valores dos atributos dos objetos que incluem o módulo ActiveFile: 


module ActiveFile 
def included (base) 
base .extend ClassMethods 
base.class eval do 
attr reader :id, :destroyed, :new record 


def initialize(parameters = {}) 
@id = self.class.next id 
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@destroyed = false 
Onew record = true 


parameters.each do |key, value| 
instance variable set "@#{key}", value 
end 
end 
end 
end 
end 


Iteramos o argumento parameters e para cada atributo ( key) definimos seu 
respectivo valor ( value) utilizando o método instance variable set. Existe 
uma ressalva a ser feita, o argumento parameters é inicializado com um Hash 
vazio para quando o método new for chamado sem nenhum argumento, o código 
funcione normalmente. 

Agora ao criar um objeto do tipo Revista, podemos passar o valor dos atribu- 
tos @tituloe valor 


revista = Revista.new titulo: "Veja", valor: 10.90 


p revista.titulo # => Veja 
p revista.valor # => 10.90 


revista.save 


Com isso eliminamos todo o código existente na classe Revista referente a 
persisténcia dos dados em arquivos. 


8.9 METHOD LOOKUP E METHOD MISSING 


Vamos relembrar alguns conceitos vistos neste capitulo. A primeira coisa importante 
que temos que lembrar é sobre variáveis de instância, elas sempre estão dentro do 
contexto de um objeto, seja ela uma instância de Class ou de qualquer outra classe 
definida, isso que dizer que o interpretador Ruby sempre irá procurá-las dentro do 
current object. 

Quando falamos de métodos a história é um pouco diferente. Existem contai- 
ners onde podemos definir métodos: Classes, Módulos e as Singleton Classes. Re- 
lembrando brevemente cada um deles temos: 
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e Classes: são instâncias de Class que representam as definições de um modelo 
em nosso sistema. Por exemplo o objeto Class que guarda as informações 
referentes à Revista. 


e Módulos: são parecidos com classes, porém, não podem ser instanciados. Ser- 
vem como containers de método que serão compartilhados com várias classes 


do sistema. 


e Singleton Class: instância criada automaticamente para armazenar informa- 
ções referentes a um objeto específico. Através dela, podemos definir compor- 
tamentos específicos por objeto. 


Existe um conceito muito importante que já foi visto em várias partes do capítulo, 
porém, não vimos concretamente como funciona este processo. O method lookup 
consiste na maneira que o interpretador Ruby procura pelo método que precisa ser 
executado. Quando invocamos um método em um objeto do tipo DVD, por exemplo, 
o primeiro lugar onde o interpretador irá procurá-lo será na classe que armazena os 
métodos específicos dos objetos DVD, ou seja, o objeto do tipo Class referente a 
classe DVD: 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
windows.titulo 


DVD 


titulo() 


windows 
singleton class 
windows 


desconto_formatado() 





Caso o método que foi invocado não exista dentro da classe DVD, o interpretador 
irá procurá-lo nos módulos que foram incluídos na classe DVD, seguindo a ordem 
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inversa de inserção dos mesmos. Portanto, tome cuidado com a ordem que você 
insere os mixings, caso eles possuam métodos “iguais, o último método incluído será 
executado. 


FormatadorMoeda 


valor formatado() 


DVD 


titulo() 


windows 
singleton class 


desconto formatado() 





Se o método também não existir dentro dos módulos incluídos na class DVD, o 
interpretador irá procurá-la na superclass da classe DVD, que neste caso, é a classe 
Midia. 


179 


8.9. method lookup e method missing Casa do Código 





Midia 


valor com desconto() 


FormatadorMoeda 


valor formatado() 


DVD 


titulo() 


windows 
singleton class 


desconto formatado() 





Uma vez que o método também não existir dentro da superclass de DVD, o in- 
terpretador irá procurá-lo então na superclass da classe Midia, que parece não estar 
definido, mas é a classe object. Lembre-se que todos as classes que não estendem 
explicitamente uma outra, tem como superclass sempre a classe Object. 
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Midia 


valor com desconto() 


FormatadorMoeda 


valor formatado() 


DVD 


titulo() 


windows 
singleton class 


desconto formatado() 





A classe Object inclui um módulo chamado Kernel, onde encontra-se, por 
exemplo, o método puts. O interpretador Ruby irá procurar pelo método invocado 
dentro deste módulo também: 
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Midia 


valor com desconto() 


FormatadorMoeda 


valor formatado() 


DVD 


titulo() 


windows 
singleton class 


desconto formatado() 





A partir do Ruby 1.9, caso o método não exista também na classe Object, existe 
um outro passo a ser percorrido, a classe BasicOb ject, que é a superclass da classe 
Object. A classe BasicObject é o topo da hierarquia de classes definidas pela 
linguagem Ruby, é o último lugar onde o interpretador irá procurar por um método 
afim de executá-lo. Caso ele não seja encontrado a exceção NoMethodError será 
lançada. 
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Midia 


valor com desconto() 


FormatadorMoeda 


valor formatado() 


DVD 


titulo() 


windows 
singleton class 


desconto_formatado() 





Este processo executado no method lookup do Ruby é conhecido como one step to 
right, then up, ou seja, o método é buscado na classe do objeto, caso não encontrado, 
o interpretador sobe na hierarquia e faz a busca até encontrá-lo. 


Como saber minha hierarquia de classes? 


Para descobrir toda a cadeia hierárquica que compõe uma determinada classe, 
basta utilizamos o método ancestors: 
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p DVD.ancestors 
# => [DVD, FormatadorMoeda, Midia, Object, Kernel, BasicObject] 


Repare queo Array retornado representa exatamente o fluxo que foi explicado. 


Trabalhando com method missing 


Vimos na seção anterior que o interpretador Ruby busca pelo método que pre- 
cisa ser executado, olhando primeiro na singleton class do objeto, depois na classe 
do objeto, na superclasse da classe do objeto, assim por diante, até chegar na classe 
BasicObject. Quando o interpretador Ruby não encontra o método, ele na ver- 
dade executa a chamada de um hook method chamado method missing. 

Quando um hook method é invocado o processo pela busca do método que deve 
ser executado é exatamente o mesmo de um outro método, o interpretador per- 
corre toda a hierarquia de classes. Entretanto, neste caso, o interpretador encontra a 
implementação do método method missing definido na classe BasicObject, 
desta maneira a busca pelo método termina neste ponto. O comportamento padrão 





deste método é lançar uma exceção do tipo NoMethodError, ou seja, quando in- 
vocamos um método que não existe na hierarquia de classes do objeto, o método 
method missing é executado e por esse motivo recebemos uma exceção. 

O importante de entender todo esse processo, é que o método 
method missing é um método como qualquer outro, de modo que pode- 
mos sobrescrevê-lo e criar um comportamento próprio para tratar casos onde um 
método não existe. O maior exemplo disso é o ActiveRecord, que faz o mapeamento 
entre o objeto e o banco de dados. Quando utilizado, o ActiveRecord mapeia todas 
as colunas de uma tabela para métodos get e set em objeto cujo tipo é o nome da 
própria tabela, porém, não obrigatoriamente: 


class Revista < ActiveRecord: :Base 
end 


Se a tabela Revista tiver uma coluna chamada nome, ao criarmos um objeto do 
tipo Revista, podemos obter e alterar o valor do campo: 


revista = Revista.new 
revista.nome = "MundoJ" 
p revista.nome # => MundoJ 


Estão disponíveis método de busca na classe Revista. Se quisermos, por exem- 
plo, buscar por todas as revistas cujo nome for “Mundo)J”, podemos fazê-lo utilizando 
um método chamado find by nome: 
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mundo j = Revista.find by nome "MundoJ" 


Se tivermos uma coluna chamada valor, podemos fazer a busca por valor, 
utilizando um método chamado find by valor: 


mundo j = Revista.find by valor 90.8 
Podemos fazer combinações de busca por dois campos ao mesmo tempo: 


mundo j = Revista.find by nome and valor "MundoJ", 90.8 


Obviamente, todos estes métodos são criados e manipulados via metaprogra- 
mação. Mas neste caso específico, a implementação da classe ActiveRecordBase 
reimplementa o método method missing. Com esta alteração, 


todas as chamadas de métodos inexistentes feitas em um 





objeto do tipo ActiveRecordBase acarretarão na execução deste novo 
method missing que possui uma implementação amarrada com as colunas 
existentes do banco de dados. 

Exemplificando, ao invocarmos o método find by nome na classe Revista, 
o interpretador Ruby buscará por ele na hierarquia de classes normalmente, como 
este método não existe, o hook method method missing mais próximo da 
classe Revista será executado, ou seja, o método reimplementado na classe 
ActiveRecord: :Base 

Esta nova implementação utiliza convenções e verifica pri- 
meiramente se o método que desejamos invocar segue o padrão 
find by alguma coluna da tabela. Em caso positivo, o segundo passo é 
verificar se a coluna existe no banco de dados, caso exista uma busca por este campo 
e pelo valor passado na invocação do método são efetuados no banco de dados. Se 
a coluna não existir ou o método na estiver no padrão de nomes do Active Record, 
a implementação definida na classe BasicObject é invocada através do método 


super. 


Implementando finders 


Vamos criar métodos finders para efetuar buscas na classe Revista através de 
seus fields utilizando method missing. O intuito é permitir que os seguintes mé- 
todos sejam invocados: 


mundo j = Revista.find by titulo "MundoJ" 
mundo j = Revista.find by valor 90.8 
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Vamos utilizar o method missing no módulo ActiveFile para suportar 
estes comportamentos: 


module ActiveFile 
module ClassMethods 
def method missing(name, *args, &block) 
load all.select do lobject| 
field = name.to s.split(" ").last 
object.send(field) == args.first 
end 
end 


private 


def load all 
Dir.glob('db/revistas/*.yml').map do |file| 
deserialize file 
end 
end 


def deserialize(file) 
YAML.load File.open(file, "r") 
end 
end 
end 


Podemos invocar agora um método chamado find_by_titulo: 


# Retorna todas as revistas cujo titulo é 'MundoJ' 
revistas = Revista.find by titulo "MundoJ" 


Explicando o código com mais detalhes. O primeiro passo foi redefinir o método 
method missing, que recebe três argumentos: 


1) name - nome do método que está sendo invocado e não foi definido em nenhum 
classe da hierarquia 


2) *args - argumentos passados para o método que foi invocado 


3) &block - bloco de código passado na chamado do método inexistente que pode 
ser executado com yield. 
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A implementação do método method missing invoca um método private 
chamado load all que percorre todos os arquivos .yml do diretório onde estão 
localizados os objetos serializados do tipo Revista, os deserializa e adiciona-os 
dentro de um Array retornado no final do método. 


Com todos os objetos Revista em mãos é possível filtrar os que desejamos uti- 





lizando o método select da API Enumerable. Na chamada ao método select 
nós fizemos o split no nome do método que está sendo executado (no exem- 
plo: “find by titulo”) pelo caractere _, e obtemos a última ocorrência, neste caso a 
String cujo valor é titulo. 

Com o nome do campo pelo qual desejamos efetuar o filtro em mãos, basta aces- 
sar o valor da variável titulo utilizando o método sende comparando o seu resul- 
tado com o primeiro argumento passado, que corresponde ao primeiro parâmetro 
da chamada ao método find by titulo: “Mundo”. 


Entretanto nosso código está frágil: 


# NoMethodError: undefined method ~blah' for #<Revista:0x007£d0328369e0> 
Revista.blah 


O problema esta na chamada ao método send que recebeua String blah 
como argumento. Como os objetos Revista não possuem nenhum método acessor 





chamado blah, a exceção NoMethodError é lançada. Devemos nos precaver e 
programar defensivamente sempre que redefinirmos o método method missing. 

A solução neste caso é verificar queo field pelo qual desejamos efetuar a busca, 
existe ou não naquele objeto: 


module ActiveFile 
module ClassMethods 
def method missing(name, *args, &block) 
field = name.to s.split(" ").last 
super if @fields.include? field 


load_all.select do |object| 
object.send(field) == args.first 
end 
end 


private 


def load all 
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Dir.glob('db/revistas/*.yml').map do |filel 
deserialize file 
end 
end 


def deserialize(file) 
YAML.load File.open(file, "r") 
end 
end 
end 


A verificação feita, invoca o method missing original (herdado da classe 
BasicObject) casoo field que estamos acessando não esteja registrado na variá- 
vel de instância @fields. O comportamento feito para efetuar buscas por objetos 
somente é válido caso esteja sendo feita por um atributo válido, qualquer outro caso, 
o method missing original é invocado. Lembre-se que é altamente recomendável 
invocar o method missing original utilizando o método super, quando alguma 
situação sair do controle da reimplementação que foi feita. 


8.10 UTILIZANDO EXPRESSÕES REGULARES NAS BUSCAS 


A maioria dos atributos que trabalhamos até o momento são do tipo string. Com 
a classe String é possível fazer diversas operações e transformações com seus mais 
de 100 métodos. Porém, algumas vezes é necessário buscar determinado conjunto 
de caracteres e substituí-los por outros, ou até mesmo criar validações para uma 
String, como verificar se ela é um email válido, por exemplo. Nestas ocasiões uti- 
lizamos as expressões regulares. 


O que uma expressão regular pode fazer por mim 


Um expressão regular consiste em um pattern que pode ser avaliado junto à uma 
String. Na teoria isso significa fazer comparações como: “o texto que está escrito 
aqui” contém a sequência de caracteres “escrito”, por exemplo. Na prática as expres- 
sões regulares servem para: 


e Testar se uma String ‘casa com um determinado pattern 


* Extrair partes de uma String que ‘casam com um determinado pattern 
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e Alterar uma String, substituindo partes que casam com um determinado 
pattern por outra String 


Criando métodos de busca utilizando expressões regulares 


Existem várias maneira de criar expressões regulares em Ruby, mas vou mostrar 
a mais básica delas, utilizando o caractere ‘/. Portanto, em Ruby ao escrevermos 
/windows/, estamos criando uma expressão regular que utilizaremos para comparar 
com Strings. Essa simples expressão regular ‘casa, por exemplo, com as seguintes 


Strings: “windows xp” “blue windows”. Mas não casa com as Strings: “window”, 
“Windows”. 





ESCAPANDO CARACTERES ESPECIAIS 


Existem alguns caracteres especiais utilizados para construir expres- 
sões regulares, por exemplo o caractere ‘/. Se quisermos criar uma ex- 
pressão regular que possua ‘/’ devemos escapá-la: 


/windows\/xp/ # casa com 'windows/xp' 
P P 











O método find_by_titulo poderia receber uma expressão regular e não 
uma String como argumento. Desta maneira, a busca se tornaria mais pode- 
rosa e não existiria necessidade de saber o título exato de uma Revista para 
recuperá-la. Como a implementação do método find by titulo é feita den- 
tro do método method missing, precisamos fazê-lo genérico a ponto de receber 
como argumento uma String, uma expressão regular eum Float (para o método 
find by valor). 

Utilizaremos então o método kind of? paraverificar o tipo de argumento pas- 
sado, para saber que tipo de comparação é necessária dentro do select executado 
como Array de objetos Revista: 


module ActiveFile 
module ClassMethods 
def method missing(name, *args, &block) 
argument = args.first 
field = name.to s.split(" ").last 
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end 


super if @fields.include? field 


load all.select do |object| 
should select? object, field, argument 
end 
end 


private 


def should select?(object, field, argument) 
if argument.kind of? Regexp 


object.send(field) =~ argument 
else 
object.send(field) == argument 
end 
end 


def load_all 
Dir.glob('db/revistas/*.yml').map do |filel 
deserialize file 
end 
end 


def deserialize(file) 
YAML.load File.open(file, "r") 
end 


end 


O operador =~ tenta casara String comoa Regexp passada como argumento, 


se o argumento passado realmente for uma instância de uma expressão regular. Caso 


a expressão regular não case com a String o valor nil é retornado, caso case a 


posição inicial (onde a expressão regular começa a casar com a String) é retor- 


nada. Como nil equivalea false e qualquer outro valor equivale a true, caso 


a expressão regular case com o título do DVD o objeto é retornado na chamada do 


método find by titulo: 


# Retorna todas as revistas cujo titulo comecem com 'Mundo' 


revistas = Revista.find by titulo /Mundo/ 
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UTILIZANDO CARACTERES ESPECIAIS DENTRO DE EXPRESSÕES 
REGULARES 


Quando as expressões regulares são criadas utilizando /expressao 
regular/' precisamos escapar os caracteres ‘/’: 


/windows\// # casa com 'windows/xp' 
p 


Se a expressão regular for bastante complexa, fica quase impossível 
interpretá-la visualmente. Nestes casos, utilizamos uma outra maneira 
de instanciar expressões regulares em que é possível adicionar caracteres 
“P sem precisar escapá-las: 


hr(windows/) & gera a expressão regular /windows\// 











Melhorando o method missing 


A verificação feita na implementação do method missing para saber por qual 
field desejamos efetuar a busca, está muito frágil: 


Revista.abc titulo "MundoJ" 


Podemos efetuar a busca utilizando qualquer nome de método que possua um 


_ seguido do nome do field. Lembrando que esse comportamento é executado 
na linha de código abaixo: 


field = name.to s.split(" ").last 


Podemos tornar este código mais seguro utilizando uma expressão regular que 
verificará se o nome do método começa com find by: 


module ActiveFile 
module ClassMethods 
def method missing(name, *args, &block) 
super unless name.to s =~ /“find by / 


argument = args.first 
field = name.to s.split(" ").last 
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super if @fields.include? field 


load_all.select do |object| 
should_select? object, field, argument 
end 
end 
end 


Agora nossa implementação de method missing invoca o 
method missing herdado através de super caso o nome do método não 
case com a expressão regular /“find by /. Agora ao executarmos invocarmos 
um método abc titulo: 


# NoMethodError 
Revista.abc_titulo "MundoJ" 


O method missing original é invocado. 


Extraindo a variável fielda partir da expressão regular 


A implementação do method missing está mais segura, porém, existem pon- 
tos que podem ser melhorados. Ainda utilizamos o método split para extrair o 
nome do field pelo qual desejamos fazer a busca. Podemos extrair este valor a 
partir da expressão regular que fizemos anteriormente, utilizando grupos: 


"Windows XP" =~ /Windows (.*)/ 
"Windows 98" =~ /Windows (.*)/ 
"Windows Vista" =~ /Windows (.*)/ 


Os grupos sao delimitados por parenteses () definidos dentro da expressao re- 
gular. No exemplo acima, o grupo criado irá capturar as Strings: “98”, “XP” e 
“Vista” respectivamente. Mas como podemos recuperar estes valores? Simples, basta 
utilizar uma variável chamada $numero do grupo: 


"Windows XP" =~ /Windows (.*)/ 
p $1 # => "Xp" 


"Windows 98" =~ /Windows (.*)/ 
p $1 # => "gg" 


"Windows Vista" =~ /Windows (.*)/ 
p $1 # => "Vista" 


192 


Casa do Código Capítulo 8. Metaprogramação e seus segredos 





Como na expressão regular acima, definimos apenas 1 grupo, acessamos ele 
utilizando $1. Se tivéssemos definido mais grupos, a regra seria a mesma, 
Snumero do grupo. 

Agora podemos alterar a implementação do method missing para extrair o 
nome do field de um grupo da expressão regular: 


module ActiveFile 
module ClassMethods 
def method missing(name, *args, &block) 
super unless name.to s =~ /“find by (.*)/ 


argument = args.first 
field = $1 


super if @fields.include? field 


load_all.select do lobject| 
should select? object, field, argument 
end 
end 
end 
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SUBSTITUINDO VALORES UTILIZANDO EXPRESSÕES REGULA- 
RES 


Expressões regulares são tão poderosas que nos permite substituir de- 
terminada ocorrência em uma String por outro valor. Por exemplo: 


mundo java = Revista.new titulo: "Mundo Java" 
p mundo java.titulo.sub /Java/, "J" & => "Mundo J" 


O método sub procura a primeira ocorrência que case com a expres- 
são regular na String e substitui pelo valor do segundo argumento: 


mundo java = Revista.new titulo: "Mundo Java Java" 
p mundo java.titulo.sub /Java/, "J" & => "Mundo J Java" 


Se quisermos substituir todas as ocorrência utilizamos o método 


gsub: 


mundo java = Revista.new titulo: "Mundo Java Java" 
p mundo java.titulo.gsub /Java/, "J" & "Mundo J J" 


Os método sub e gsub retornam novos objetos do tipo String. 
Caso queira alterar a St ring original basta invoca os método utilizando 
o caractere !: 


mundo java = Revista.new titulo: "Mundo Java" 
mundo java.titulo.gsub! /Java/, "J" 
p mundo java.titulo # => "Mundo J" 











8.11 PROXIMOS PASSOS 


Neste capítulo vimos conceitos básicos e avançados sobre metaprogramação. Apren- 
demos a criar método dinamicamente utilizando define method e também o fa- 
moso e perigoso method missing que serve como fallback para métodos que não 
existem no objeto receptor. Estes são conceitos amplamente utilizados em bibliote- 
cas que os desenvolvedores Ruby utilizam no dia a dia, por isso a importância de 
aprendê-los. São poucos os casos em que utilizamos recursos tão avançados. 


E por falar em bibliotecas, no próximo capítulo aprenderemos como funcionam 
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a distribuição e utilização delas em projetos. Aprenderemos a criar um biblioteca, 
distribuí-la e como gerenciar dependências em projetos Ruby. 


195 


CAPITULO 9 


As bibliotecas no universo Ruby 


Em linguagens modernas como Ruby, é comum a utilização de bibliotecas que acele- 
rem o desenvolvimento. Estas bibliotecas são distribuídas no universo Ruby através 
de gems, que são arquivos que terminam com a extensão .gem, onde ficam locali- 
zados o código fonte da biblioteca e também informações e metadados, como versão 
e nome. 

Neste capítulo, nós aprenderemos a instalar e gerenciar estas gems e também 


como criar e distribuir uma. 


9.1 COMO MANUSEAR SUAS GEMS COM O RUBYGEMS 


Rubygems é o framework padrão que utilizamos para empacotar, instalar, atualizar 
e remover bibliotecas escritas em Ruby dentro de um aplicativo ou outra biblioteca. 
Atualmente, todas as bibliotecas modernas e atualizadas estão disponíveis para ins- 
talação através do Rubygems. Com apenas um comando, todo o processo de baixar 
a gem na internet e instalá-la é feito automaticamente. 
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O próprio Rubygems disponibiliza uma ferramenta de linha de comando para 
gerenciar as gems. Tudo pode ser feito utilizando o comando gem que está disponível 
automaticamente se você estiver utilizando uma versão do Ruby superior a 1.9. Nas 
versões mais antigas era necessário instalar o Rubygems manualmente. 


Instalando uma gem 


Os valores dos livros, dvds e cds da nossa loja virtual estão sendo impressos com 
o prefixo "R$". Queremos agora que o valor seja impresso por extenso e ao invés 
de escrever um código que faz isso, utilizaremos uma gem criada por brasileiros 
chamada brnumeros, cujo objetivo é manipular números de acordo com padrões 
propostos apenas no Brasil. Para instalá-la, basta executar o seguinte comando no 
seu terminal: 


gem install brnumeros 


A saída do console deve ser parecida com a saída abaixo se a instalação foi feita 
com sucesso: 


Fetching: brnumeros-3.3.0.gem (100%) 

Successfully installed brnumeros-3.3.0 

1 gem installed 

Installing ri documentation for brnumeros-3.3.0... 
Installing RDoc documentation for brnumeros-3.3.0... 


As duas últimas linhas indicam que a documentação (RDoc) da gem foi instalada 
também. Caso você não queira que a documentação seja instalada, basta passar a 





opção --no-rdoc --no-ri. 
Após a instalação, você pode verificar as gems disponíveis através do comando 
gem list, que retorna todas as gems instaladas: 


xxx LOCAL GEMS *** 


brnumeros (3.3.0) 


Utilizando a gem instalada 


Uma vez que a gem foi instalada, basta utilizarmos o método require para 
carregá-la dentro do código fonte da nossa aplicação, assim como fizemos com bi- 
bliotecas nativas anteriormente. É necessário também executar um require nas 


rubygems: 
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require 'rubygems' 
require 'brnumeros' 


Vamos então adicionar um novo método no módulo Format adorMoeda cha- 


mada valor por extenso 


# carregando rubygems 
require 'rubygems' 

# carregando gem brnumeros 
require 'brnumeros' 


module FormatadorMoeda 
module ClassMethods 
def formata_moeda(*variaveis_e_metodos) 
variaveis_e_metodos.each do |name| 
define_method("#{name}_formatado") do 
valor = respond_to? (name) 
? send(name) 
instance_variable_get ("@#{name}") 
"R$ #{valor}" 
end 


# metodo que retorna valor por extenso em reais 

def ine_method("#{name}_por_extenso") do 
valor = respond to? (name) 

? send (name) 
instance_variable_get("@#{name}") 

valor.por_extenso_em_reais 

end 

end 
end 
end 


def self. included (base) 
base.extend ClassMethods 
end 
end 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 


windows.valor por extenso 
# => noventa e oito reais e noventa centavos 
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O código não possui muitas novidades, apenas a utilização da gem brnumeros 





através da chamada ao método por extenso em reais que pega o valor de um 
Integer ou Float e retorna uma String com o valor por extenso. 


Instalando versões específicas de uma gem 


Em algumas ocasiões é necessário instalar uma determinada versão de uma 
gem, por exemplo, em casos de incompatibilidade de outras gems que utiliza- 
mos no nosso sistema. O comando gem permite que seja passado um parâme- 
tro --version versao desejada. Podemos instalar uma versão mais antiga 


da gem brnumeros: 


gem install brnumeros --version '3.2.0' 


Fetching: brnumeros-3.2.0.gem (100%) 
Successfully installed brnumeros-3.2.0 
1 gem installed 


Da maneira que o parâmetro --version foi especificado, a versão 3.2.0 será 
instalada. Mas podemos ser mais flexíveis e, por exemplo, instalar qualquer versão 
que seja maior que a versão 3.2.0: 


gem install brnumeros --version '> 3.2.0! 


Fetching: brnumeros-3.3.0.gem (100%) 
Successfully installed brnumeros-3.3.0 
1 gem installed 


Ou ainda especificar que a versão instalada deve ser a última versão de um de- 
terminado minor. Por exemplo, instale a última versão 3.0.x: 


gem install brnumeros --version '~> 3.0.0! 
Fetching: brnumeros-3.0.8.gem (100%) 


Successfully installed brnumeros-3.0.8 
1 gem installed 


9.2 GERENCIANDO VÁRIAS VERSÕES DE UMA GEM 


Como acabamos de ver, podemos instalar uma versão mais antiga da gem 


brnumeros: 
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gem install brnumeros --version '3.2.0' 


Agora ao rodarmos o comando gem list veremos as duas versões: 


*** LOCAL GEMS *** 


brnumeros (3.3.0, 3.2.0) 


Mas qual das duas versões serão utilizadas no módulo FormatadorMoeda? A 
resposta é: a última. Se você precisa utilizar a versão mais antiga da gem em um 
determinado projeto, basta utilizar o método gem dentro do código, especificando 
qual versão será carregada: 


# carregando rubygems 
require 'rubygems' 


# carregando gem brnumeros versao 3.2.0 
gem 'brnumeros', '3.2.0' 
require 'brnumeros' 


module FormatadorMoeda 
module ClassMethods 
end 

end 


O método gem, diz que a gem brnumeros deve ser carregada na versão 3.2.0. 
Porém, essa metodologia de gerenciar as versões das gems que desejamos utilizar 
pode se tornar um problema com o passar do tempo, principalmente porque no 
universo Ruby é muito comum termos várias dependências em um mesmo projeto, 
mesmo que este seja pequeno. Controlar cada versão é muito trabalhoso, por isso 
atualmente existem gerenciadores de dependências escritos em Ruby que facilitam 
nossa vida e cuidam destas preocupações para a gente. 


9.3 GERENCIE DEPENDÊNCIAS COM O BUNDLER 


A forma mais eficaz de gerenciar dependências em projetos Ruby é através de uma 
gem chamada Bundler. Sua função é garantir que o código da sua aplicação usará 
as versões exatas das gems das quais ela depende. Para utilizar o Bundler devemos 
primeiro instalá-lo: 


gem install bundler 
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As dependências da sua aplicação devem ser declaradas dentro de uma arquivo 
chamado Gemfile. Esse arquivo deve, primeiramente, conter a fonte de onde as 
dependências serão baixadas: 


source "http://rubygems.org" 


A declaração source indica que as gems serão baixadas do repositório oficial do 
Rubygems. O próximo passo é declarar quais são as gems que são dependências do 
projeto: 


source "http://rubygems.org" 


gem "brnumeros", "3.3.0" 


Na declaração gem, indicamos o nome e a versão que desejamos. Na declaração 
da versão podemos seguir o mesmo padrão que seguimos ao instalar um gem ma- 
nualmente. No Gemfile do nosso exemplo, a versão instalada será exatamente a 
versão 3.3.0, se quisermos instalar a última versão do minor 3.2.x, a declaração seria 


feita da seguinte maneira: 


source "http://rubygems.org" 


gem "brnumeros", "~> 3.3.0" 


Para que as gems sejam instaladas respeitando o que foi definido no Gemfile, 
basta rodarmos o comando bundle install no terminal, que irá gerar um novo 
arquivo chamado Gemfile.lock, que especifica todas as gems obtidas para o 
Gemfile e sua respectiva versão baixada. 

O Gemfile.lock é uma boa alternativa para congelar as versões das gems a 
serem utilizadas, uma vez que ao rodarmos o comando bundle install sobrea 
presença de um Gemfile.1ock,as versões presentes nesse arquivo serão utilizadas 
para especificar as gems a serem baixadas. 

Para que as versões especificadas no Gemfile sejam respeitadas durante o load 
da aplicação, precisamos carregar uma classe do bundler: 


require 'bundler/setup' 
require 'brnumeros' 


module FormatadorMoeda 
module ClassMethods 
end 

end 
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Automaticamente a versão especificada no Gemfile será carregada para a gem 
brnumeros. Agora ao invés de executar um irb no terminal para testar as classes 
que estamos construindo, execute o comando bundle console queabreo irb 


com o bundle pré-carregado: 
bundle console 


require File.expand path('lib/loja virtual!) 


windows = DVD.new "Windows 7 for Dummies", 98.9, :sistemas operacionais 
windows.valor. por extenso 


Resolvendo conflitos com bundle exec 


Existem gems que criam caminhos executáveis para utilizarmos no console, o 
próprio Bundler nos disponibiliza comandos úteis como o bundle console. 
A gem rake, que será explorada no próximo capítulo, cria um executável que nos 
permite rodar tasks a partir do terminal: 


rake -T 


O comando acima lista todas as tasks definidas pela aplicação. Porém, se tiver- 
mos mais de uma versão da gem rake instalada no sistema eno Gemfile da apli- 
cação estiver especificada alguma destas versões, o comando acima acusará um erro: 


rake aborted! 
You have already activated rake 10.0.3, 
but your Gemfile requires rake 10.0.2 


Basicamente isso significa que no Gemfile da aplicação esta especificada a ver- 
são 10.0.2 da gem rake, enquanto no sistema existe uma versão mais nova 10.0.3. Se 
você não puder atualizar a versio do rake no seu Gemfile, é necessário executar 
o comando rake, utilizando um outro comando chamado bundle exec: 


bundle exec rake -T 


O comando bundle exec executará todos os comandos ( rake, rails, etc) 
respeitando a versão descrita no Gemfile, neste exemplo, o comando rake -T 
será executado com a versão 10.0.2, resolvendo o conflito. No capítulo sobre RVM 
veremos que existe uma alternativa ao uso do comando bundle exec. 
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9.4 QUEM USA BUNDLER? 


O Rails, o mais famoso framework do mundo Ruby, utiliza por padrão o Bun- 
dler para gerenciar as suas dependências. Qualquer aplicação Rails terá um ar- 
quivo Gemfile com as dependências, portanto, é essencial entender como utilizá- 
lo. Você pode ver mais detalhes da excelente documentação disponível no site: 
http://gembundler.com/ 


9.5 CRIANDO E DISTRIBUINDO GEMS 


Como foi dito anteriormente, uma gem nada mais é que um arquivo compac- 
tado com o código fonte da biblioteca e um arquivo que contém os metadados, 
como nome, versão e outras dependências. Vamos distribuir o código da classe 
ActiveFile em uma gem. 

É recomendável que uma gem tenha uma estrutura definida de diretórios. O pró- 
prio bundler possui um bootstrap que gera estes diretórios de maneira que não é ne- 
cessário criá-los manualmente. Rodando o comando bundle gem active file 
que irá gerar a seguinte saída: 


create active file/Gemfile 

create active file/Rakefile 

create active file/LICENSE 

create active file/README.md 

create active file/.gitignore 

create active file/active file.gemspec 

create active file/lib/active file.rb 

create active file/lib/active file/version.rb 


Com a seguinte estrutura: 
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Do Name O  » Date Modified Size Kind 
active file.ggemspec Jan 8, 2013 12:38 AM 408 bytes Document 
| Gemfile Jan 5, 2013 12:39 AM 96 bytes Document 
> Gemfile.lock Jan 12, 2013 3:23 PM 143 bytes Document 
v Glib Today 11:56 AM -- Folder 
v (pi active file Jan 5, 2013 12:39 AM -- Folder 
E version.rb Jan 11, 2013 12:05 AM 42 bytes Ruby Source 
«b active file.rb Feb 24, 2013 10:50 AM 2 KB Ruby Source 
> (@ tasks Jan 8, 2013 12:29 AM = Folder 
LICENSE Jan 5, 2013 12:39 AM 1KB Document 
— Rakefile Jan 11, 2013 12:04 AM 629 bytes Document 
* README.md Jan 5, 2013 12:39 AM 510 bytes Markd...ument 
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Sem dúvida, o mais importante desta estrutura é a pasta 1ib. É nela que ficam 
localizados os arquivos com código Ruby que compõem a biblioteca. Este diretó- 
rio é adicionado ao GEM PATH do RubyGems para informar quais bibliotecas estão 





disponíveis para uso. 

O RubyGems sobrescreve o método require do módulo Kernel com uma 
implementação que faz uma busca pela gem que você precisa utilizando os diretórios 
adicionados ao GEM PATH. Por isso, sempre que utilizamos o método require 





"alguma biblioteca", o RubyGems irá procurar por um arquivo chamado 
lib/alguma biblioteca.rb. Por esse motivo a importância de termos um di- 
retório lib. 


Abrindo o arquivo active file/lib/active file. rb temos o seguinte 





conteúdo: 


require "active file/version" 


module ActiveFile 
# Your code goes here... 
end 


Somente um arquivo é carregado e ele contém a versão da gem, importante no 
momento da geração do arquivo .gem que veremos mais a frente. Também foi de- 
clarado um módulo com o nome da gem usando a notação camel case. Essa definição 
é muito importante, lembre-se que os módulos servem para criarmos namespaces, e 
com isso evitamos conflitos com outras gems utilizadas como dependências. 

Dentro deste módulo é necessário incluir o código do módulo Act iveFile que 
está dentro da aplicação, o mesmo código que fizemos no capítulo anterior. Todo o 
código da implementação da gem active file está disponível no meu github: 
http://github.com/lucasas/active file você pode copiar o código diretamente de lá. 


9.6 DISTRIBUIÇÃO DA BIBLIOTECA 


Para gerar um arquivo .gem precisamos de um arquivo .gemspec, que possui os 
metadados da nossa biblioteca. Como criamos nossa biblioteca utilizando o Bundler 


um arquivo .gemspec foi criado automaticamente com o seguinte conteúdo: 


require File.expand path('../lib/active file/version', __FILE__) 


Gem: :Specification.new do |gem| 
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gem.authors = ["Lucas Souza"] 

gem.email = ["lucasas@gmail.com"] 
gem.description = %q{TODO: Write a gem description} 
gem.summary = %q{TODO: Write a gem summary} 


gem. homepage = BE 


gem.files = “git ls-files* .split($\) 
gem.executables = gem.files.grep(/r{“bin/}) 

-map{ |f| File.basename(f) } 
gem.test_files = gem.files.grep(/r{7 (test |spec|features) /}) 
gem.name = "active_file" 
gem.require_paths = ["lib"] 
gem.version = ActiveFile: : VERSION 

end 


Vamos apagar o conteúdo e reescrevé-lo apenas com as informações mais rele- 


vantes: 


require File.expand path('../lib/active file/version' FILE ) 


E 


Gem: :Specification.new do |gem| 


gem.name = "active_file" 

gem.version = ActiveFile: : VERSION 
gem.description = "Just a file system database" 
gem. summary = "Just a file system database" 
gem.author = "Lucas Souza" 


gem.files = 
Dir ["(1ib/+*/*.rb,README .md,Rakefile,active file.gemspec)"] 
end 


As informações declaradas são autodescritivas, sendo a mais importante delas 
s.files que indica quais arquivos formarão o código fonte da gem. 
Com essas informações no arquivo .gemspec basta rodarmos o comando gem 


build active file.gemspec eum arquivo active file-0.0.1.gemserá 








gerado. Para instalar a gem recém criada, basta rodar o comando gem install 
active file-0.0.1.gem --local. Após isso basta rodar o comando gem 
list active file -d para verificar que a gem foi instalada com sucesso. 


*** LOCAL GEMS *** 
active_file (0.0.1) 
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Author: Lucas Souza 
Installed at: /Users/lucas/.rvm/gems/ruby-1.9.2-p290 


Just a file system database 


Por fim, se quisermos distribuir esta gem para desenvolvedores Ruby no mundo 
inteiro, basta criar um conta no site http://rubygems.org e submetê-la. Para isso, 
basta executar o comando gem push active file-0.0.1.gem e serão soli- 
citados email e senha recém criados. Após o upload da gem, basta acessar http: 
//rubygems.org/gems/active_file. 

Precisamos agora preparar nosso projeto para que ele deixar de utilizar o mó- 
dulo ActiveFile que está dentro do próprio projeto e passe a utilizar a gem 
active file que criamos, que está no rubygems. Como nosso projeto já uti- 
liza a gem brnumeros como dependência e usará a gem active file também 
como dependência, podemos utilizar o bundler para gerenciá-las: 


source 'http://rubygems.org' 


gem 'brnumeros', '3.3.0' 
gem 'active_file', '0.0.1' 


Rodando um bundle install, as dependências são instaladas. Precisa- 
mos também apagar o arquivo active file.rb do projeto e adicionar a linha 


require 'active file' noarquivo revista.rb: 


require 'bundler/setup' 
require 'active file! 


class Revista 


# implementação 
end 


Agora estamos utilizando o módulo ActiveFile a partir da gem. 


Adicionando dependências em uma gem 


Quando criamos uma gem é comum utilizarmos outras gems para nos auxiliar. 
Com isso criamos um dependência implícita, ou seja, o projeto que depender da sua 
gem, dependerá automaticamente da gem que você utilizou em sua criação. 
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Neste caso é recomendável declarar essas dependências no arquivo .gemspec, 
assim ao instalar a gem em outros projetos, as dependência implícitas também serão 
instaladas: 


Gem::Specification.new do |gem| 


gem.name = “active filé” 

gem.version = ActiveFile: : VERSION 
gem.description = "Just a file system database" 
gem. summary = "Just a file system database" 
gem.author = "Lucas Souza" 


gem.files = 
Dir ["{lib/**/*.rb,README.md,Rakefile,active_file.gemspec}"] 


# dependência do código com a gem brnumeros 
gem.add_dependency "brnumeros", "~> 3.3.0" 
end 


Precisamos também carregar as dependências da gem no arquivo 


active file.rb: 


# coding utf-8 


# carregando dependéncias 
require "brnumeros" 
require "FileUtils" 


require "active_file/version" 


module ActiveFile 
# implementação 
end 


9.7 PRÓXIMOS PASSOS 


Neste capítulo aprendemos a criar, gerenciar e distribuir dependências no formato 
gem. Isso é essencial para trabalhar com qualquer projeto Ruby, afinal é muito co- 
mum utilizarmos bibliotecas prontas para fazer parte do trabalho necessário. Ge- 
renciar estas dependências também é muito mais simples utilizando a gem Bundler 





que através dos arquivos Gemfile e Gemfile.lock controla quais versões e quais 
gems utilizamos em um projeto. 

No próximo capítulo veremos como criar tasks(pequenos scripts) em aplicações 
Ruby utilizando a gem rake. 
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Criando tasks usando Rake 


Se você ja leu tutoriais ou investigou o código de algum projeto escrito em Ruby, pro- 
vavelmente você já ouviu falar de uma gem chamada rake. Suas primeiras versões 
tinham em mente criar um ferramenta de build similar ao famoso Make. Porém, a 
gem rake possui muitas ferramentas que a tornam uma poderosa biblioteca de auto- 
mação. 

O primeiro passo para utilizar o rake é instalá-lo executando gem install 
rake no seu terminal ou então adicionado-o no Gemfile do projeto e executando 
em seguida o comando bundle install. Após a instalação teremos disponível o 
comando rake, por onde executaremos os scripts de automação que serão criados. 

São muitos os passos que podem ser automatizados dentro de um projeto, desde 
rodar testes automaticamente, até realizar o build de um pacote no ambiente de pro- 
dução. 

Nosso aplicativo precisa de um script que “limpe” a base de dados, resumida- 
mente, precisamos apagar todo o conteúdo da pasta db/revistas. Isso pode ser 
feito facilmente com o seguinte código Ruby: 
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require 'fileutils' 
FileUtils.rm Dir['db/revistas/*.yml'] 


O código é bastante simples, mas se toda a vez que precisarmos apagar o banco 
de dados for necessário repetir este script, estamos bastante sujeitos a erros. Seria 
bem mais simples executar algo como rake db:clean no terminal, certo? 

Isso é possível isolando o script anterior em uma rake task. Um pequeno script 
que será executado pelo comando rake, que irá procurar por estes scripts dentro de 
um arquivo chamado Rakefile. Agem active file que criamos no capítulo 
anterior possui um arquivo chamado Rakefile com o seguinte conteúdo: 


#!/usr/bin/env rake 
require "bundler/gem_tasks" 


Como criamos a gem utilizando o bundler, automaticamente todas as suas rake 
tasks estao disponiveis para uso. Podemos remover esta linha e criar a nossa propria 
task chamada db:clear: 


#!/usr/bin/env rake 
require 'fileutils' 


namespace :db do 
task :clear do 
FileUtils.rm Dir['db/revistas/*.ym1'] 
end 
end 


Podemos agora rodar o comando rake -T que retorna uma lista com todas 
as tasks encontradas dentro do arquivo Rakefile do diretório onde rodamos o 
comando. Como a rake task não possui uma descrição, ela não será retornada 
na lista de tasks disponíveis. Resolvemos este problema adicionando uma descrição: 


#!/usr/bin/env rake 

require 'fileutils' 

desc "Limpa todas as revistas da pasta db/revistas" 
namespace :db do 


task :clear do 
FileUtils.rm Dir['db/revistas/*.yml'] 
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end 
end 


Se rodarmos novamente o comando rake -T obteremos o seguinte resultado: 


rake db:clear # Limpa todas as revistas da pasta db/revistas 


Para testarmos a rake task que acabamos de criar, basta executar no terminal 
o comando rake db:clear. Porém, não faz sentido tentarmos limpar o banco 
de dados a partir da pasta da gem active file. Precisamos expor as rake tasks 
criadas para que elas possam ser utilizadas dentro do projeto loja virtual ou de outros 
projetos onde forem utilizadas. 

O primeiro passo consiste em extrair as tasks para arquivos separados, que ficam 
em uma pasta chamada lib/tasks. Fazemos isso porque as tasks adicionadas 
dentro do Rakefile são disponibilizadas apenas se executarmos o comando rake 
dentro da pasta onde o mesmo se encontra. Vamos então extrair a task para um 
arquivo chamado db.rake: 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas as revistas da pasta db/revistas" 
task :clear do 
FileUtils.rm Dir['db/revistas/*.ym1'] 
end 
end 


Agora torna-se necessário que as tasks criadas na pasta lib/tasks sejam co- 
piadas para o arquivo .gem: 


require File.expand_path('../lib/active_file/version', __FILE__) 


Gem: :Specification.new do |gem| 


gem.name = "active_file" 

gem.version = ActiveFile: : VERSION 
gem.description = "Just a file system database" 

gem. summary = "Just a file system database" 
gem.author = "Lucas Souza" 

gem.files = Dir["{lib/**/*.rb,lib/tasks/*.rake, 


README .md,Rakefile,active_file.gemspec}"] 
end 


211 


10.1. Parâmetros na rake task Casa do Código 





Porém, ter os arquivos onde as tasks foram definidas dentro da gem não é sufici- 
ente para utilizá-las dentro de projetos externos. Existe a necessidade de carregar a 
classe active fileeasrake tasks existentes na pasta lib/tasks. Estes arquivos 
podem ser carregados utilizando o método import do rake, que carrega arquivos 
com a extensão .rake: 


# coding utf-8 


require "fileutils" 
require "active_file/version" 


require 'rake' 
import File.expand_path("../tasks/db.rake", __FILE__) 


module ActiveFile 
# implementação 
end 





A linha File.expand_path("../tasks/db.rake", FILE) retorna o ca- 
minho absoluto para o arquivo db. rake que contém as rake tasks que precisam ser 
importadas. Também foi necessário carregar o rake, pois o método import faz 
parte de sua API. 

Um ponto importante que deve ser ressaltado é que o conteúdo de um arquivo 
. rake é código Ruby, o comando task é um método Ruby que também faz parte 
da API pública do Rake, isso permite que você implemente uma rake task utilizando 
todas as APIs Ruby que desejar. 

Voltando ao código, para que a implementação possa ser testada, basta gerar uma 
nova versão da gem active file eatualizá-la dentro do projeto da loja virtual. Ao 
executar o comando rake -T dentro do projeto, o seguinte resultado será exibido: 


rake db:clear # Limpa todas as revistas da pasta db/revistas 
Isso comprova que as tasks que foram definidas dentro da gem active_file, 


podem ser aproveitadas dentro de projetos que a possuem como dependência. 


10.1 PARÂMETROS NA RAKE TASK 


E extremamente importante receber parâmetros na invocação de métodos, afim de 
flexibilizá-los. Com as rake tasks não é diferente, é muito comum a necessidade de 
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flexibilizá-las para evitar repetição de código. Por exemplo, se for necessário excluir 
o banco de dados referente a classe DVD, não faríamos algo como o código abaixo: 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas as revistas da pasta db/revistas" 
task :clear do 
FileUtils.rm Dir['db/revistas/*.ym1'] 
end 


desc "Limpa todas os dvds da pasta db/dvds" 
task :clear_dvds do 
FileUtils.rm Dir['db/dvds/*.yml'] 
end 
end 


Existe muita repetição no código acima, qualquer alteração na API FileUtils 
acarretaria em mudanças em todas as tasks que excluem dados das pastas. Além 
disso, a cada nova mídia que tivermos no sistema, será necessário criar uma nova 
task para removê-las. Ao olhar com cuidado o código é possível perceber que a única 
diferença entre as tasks é apenas o nome da pasta onde encontram-se os arquivos que 
desejamos excluir. 

O mais óbvio neste caso é receber o nome da pasta que desejamos excluir os 
arquivos *.yml, assim flexibiliza-se uma única task que será responsável por apagar 
os arquivos de qualquer mídia existente ou nova dentro do sistema. Vamos então 
receber o parâmetro folder na rake task db:clear 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas os arquivos de uma midia" 
task :clear, [:folder] do |task, args| 
FileUtils.rm Dir["db/#{args.folder}/*.ym1"] 
end 
end 


Todos os parâmetros que precisam ser recebidos na chamada da rake task, de- 
vem ser adicionados logo após seu nome em forma de um Array. Ao executar o 
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comando rake -T o rake informa que a task db: clear precisa ser invocada com 
um parâmetro chamado folder: 


rake db:clean[folder] # Limpa todas os arquivos de uma midia 


Outra alteração feita no código são os dois argumentos recebidos no bloco. O 
primeiro parâmetro task, é um objeto do tipo Rake: : Task que guarda as infor- 
mações da task, o segundo argumento args contém os valores passados na chamada 
da task em forma de open-struct, ou seja, para utilizar o parâmetro folder decla- 
rados deve-se fazê-lo utilizando args. folder, como de fato foi feito. 


Para invocar a rake task basta passar o argumento entre []: 


rake db:clear['revistas'] 
rake db:clear['dvds'] 


Multiplos parametros 


Se necessário receber vários argumentos na rake task, basta declará-los no 
Array de parâmetros definidos após o nome da task: 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas os arquivos de uma midia" 
task :clear, [:folder, :file_extension] do |task, args| 
FileUtils.rm Dir["db/#{args.folder}/*.#{args.file_extension}"] 
end 
end 


Para invocar a rake task basta informar os dois parametros separados por virgula: 


rake db:clear['revistas','yml'] 


Porém, existe um detalhe importante na chamada da rake task. Repare que nao 
colocamos o caractere de espaço na chamada da task, porque a chamada deve ser 
feita em um único comando, juntando o seu nome e argumentos. Se for necessário 
invocar a task passando nome e argumentos utilizando espaços, o argumento para o 


comando rake deve ser colocado entre aspas. Algo como o comando abaixo: 


rake "db:clear['revistas', 'yml']" 
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10.2 TASKS COM PRÉ-REQUISITOS 


Podemos criar tasks que sao utilizadas com pré-requisitos de outras. Uma task muito 
comum quando utiliza-se Active Record éa db: seed que popula o banco de dados. 


Vamos criar uma task similar ao db: seed: 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas os arquivos de uma midia" 
task :clear, [:folder] do |task, args| 
FileUtils.rm Dir["db/#{args.folder}/*.yml"] 
end 


desc "Popula com os dados definidos no arquivo db/folder/seeds.rb" 
task :seed, [:folder] do 
seed file = File.expand_path "db/#{args.folder}/seeds.rb" 
load(seed_file) if File.exist?(seed_file) 
end 
end 


A task procura por um arquivo db/seeds.rb e o carrega caso ele exista. O 
arquivo seeds. rb é contém o código Ruby que popula o banco com dados iniciais, 
por exemplo: 


require "active file" 
require "revista" 


Revista.new(titulo: "Veja", valor: 10.90) .save 
Revista.new(titulo: "Época", valor: 12.90) .save 


Ao executar a rake task pelo comando db: seed dois objetos do tipo Revista 
serão criados. 

Outra rake task bastante útil que existeno Active Recordéa db: reseed que 
possui o mesmo comportamento da db: seed, porém, remove os dados existentes 
no banco antes de populá-lo novamente. Uma task como essa pode ser implemen- 
tada facilmente na gem active file: 


# lib/tasks/db.rake 
require 'fileutils' 
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namespace :db do 
desc "Limpa todas os arquivos de uma midia" 
task :clear, [:folder] do |task, args| 
FileUtils.rm Dir["db/#{args.folder}/*.ym1"] 
end 


desc "Popula com os dados definidos no arquivo db/folder/seeds.rb" 
task :seed, [:folder] do 
seed file = File.expand_path "db/#{args.folder}/seeds.rb" 
load(seed_file) if File.exist?(seed file) 
end 


desc "Popula com os dados definidos no arquivo db/folder/seeds.rb, 
apagando os existentes" 

task :reseed, [:folder] do 
FileUtils.rm Dir["db/#{args.folder}/*.ym1"] 


seed file = File.expand_path "db/#{args.folder}/seeds.rb" 
load(seed file) if File.exist?(seed file) 
end 
end 


Repare que o código da task reseed é uma cópia das tasks clear e seed na 
ordem. Como o comportamento que desejamos executar foi feito em outras tasks, 
podemos reutilizá-las: 


# lib/tasks/db.rake 
require 'fileutils' 


namespace :db do 
desc "Limpa todas os arquivos de uma midia" 
task :clear, [:folder] do |task, args| 
FileUtils.rm Dir["db/#{args.folder}/*.ym1"] 
end 


desc "Popula com os dados definidos no arquivo db/folder/seeds.rb" 
task :seed, [:folder] do 
seed file = File.expand path "db/#{args.folder}/seeds.rb" 
load(seed file) if File.exist?(seed file) 
end 
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desc "Popula com os dados definidos no arquivo db/folder/seeds.rb, 
apagando os existentes" 
task :reseed, [:folder] => ["db:clear", "db:seed"] do 
end 
end 


Na definição da task db: reseed declaramos como pré-requisito a execução das 
tasks db: clear e db: seed declarando-as como um Array que representa o valor 
do Hash cuja chave são os parâmetros e nome da task. 


10.3 PRÓXIMOS PASSOS 


O rake é uma ferramenta essencial quando existe a necessidade de automatizar 
tarefas na linguagem Ruby. A grande maioria dos projetos escritos em Ruby e prin- 
cipalmente o Rails, o mais famoso deles, utilizam rake. Portanto, explore ainda 
mais a sua documentação e tente automatizar as tarefas do seu projeto utilizando- 
o. Outros desenvolvedores que chegarão ao projeto e conhecerem Ruby não terão 
dificuldades para lidar com esses scripts. 

No próximo capítulo, aprenderemos a lidar com várias versões do Ruby na 
mesma máquina e como separar gems em lugares diferentes, organizando melhor 
seu ambiente e evitando conflitos, utilizando RVM. 
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RVM (Ruby Version Manager) 


Ruby Version Manager, mais conhecido como RVM, permite dentre outras coisas, 
que várias versões do Ruby sejam instaladas em uma maquina. Isso é bastante útil 
principalmente nas máquinas dos desenvolvedores, que muitas vezes precisam dar 
manutenção em projetos que utilizam versões diferentes do Ruby. 

Nesse capítulo você vai aprender também que o RVM possui mais utilidades do 
que apenas trocar entre versões do Ruby. 


11.1 INSTALAÇÃO 


O primeiro passo para utilizar o RVM é instalá-lo em sua máquina. Se você utiliza 
MacOS ou Linux basta ter o curl eo make instalados. Em seguida execute o 
seguinte comando: 


bash < <(curl -s https://rvm.beginrescueend.com/install/rvm) 


Executando o comando acima, o RVM será instalado no diretório home do seu 
usuário. Como o RVM é utilizado via linha de comando, é necessário que ele seja 


11.1. Instalação Casa do Código 





carregado pelo arquivo .bash profileou .bashrc. Abra o arquivo e adicione 
a seguinte linha: 


[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" 


Ou execute a linha abaixo no terminal: 


echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && 
source "$HOME/.rvm/scripts/rvm"' >> .bash_profile 


Basta agora recarregaro .bash_profile para que o RVM esteja disponivel na 
linha de comando. 


source ~/.bash_profile 


Lembre-se que uma vez que ele estiver configurado dentro do .bashrc, sempre 
que vocé se logar, ele sera carregado automaticamente. 

Verifique que o RVM foi instalado corretamente, executando o comando: rvm 
notes que mostrará algumas informações sobre o RVM e seu sistema operacional. 





INSTALAÇÃO NO WINDOWS 


Se você utiliza Windows, também pode instalar o RVM em sua má- 
quina. Basta seguir esse post: http://blog.developwithpassion.com/2012/ 
03/30/installing-rvm-with-cygwin-on-windows que explica em deta- 
lhes como instalar e configurar o RVM em sua máquina. 











Dependendo do seu sistema operacional, é necessário a instalação de algumas 


dependências. Para visualizá-las basta executar o comando rvm requirements: 


Notes for Mac OS X 10.8.2, Xcode 4.5.2. 
For MacRuby: Install LLVM first. 


For JRuby: Install the JDK. 
See http://developer.apple.com/java/download/ 


For IronRuby: Install Mono >= 2.6 


For Ruby 1.9.3: Install libksba # If using Homebrew, 
'brew install libksba' 
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Em geral, ao executar este comando você visualizará o que precisa para instalar 
cada uma das versões do Ruby. Executar este comando com frequência garantirá que 
sua instalação continue sempre funcionando. 


11.2 INSTALANDO DIFERENTES RUBIES 


A expressão rubies é muito comum no mundo RVM, e que na verdade significa ter 
várias versões do Ruby instaladas. Mas como instala-se uma versão do Ruby utili- 
zando RVM? Vamos começar instalando a versão do Ruby MRI 1.9.3: 


rvm install 1.9.3 


Durante a instalação, você verá mensagens como: 


Installing Ruby from source to: 
/Users/lucas/.rvm/rubies/ruby-1.9.3-p194, 
this may take a while depending on your cpu(s)... 


ruby-1.9.3-p194 - #fetching 

ruby-1.9.3-p194 - #extracted to /Users/lucas/.rvm/src/ruby-1.9.3-p194 
(already extracted) 

ruby-1.9.3-p194 - #configuring 

ruby-1.9.3-p194 - #compiling 

ruby-1.9.3-p194 - #installing 

Removing old Rubygems files... 

Installing rubygems-1.8.24 for ruby-1.9.3-p194 ... 
Installation of rubygems completed successfully. 
ruby-1.9.3-p194 - adjusting #shebangs for 

(gem irb erb ri rdoc testrb rake). 

ruby-1.9.3-p194 - #importing default gemsets 
(/Users/lucas/.rvm/gemsets/) 

Install of ruby-1.9.3-p194 - #complete 


Para utilizar a versão que foi instalada utilizando RVM, basta executar: 


rvm use 1.9.3 


Agora, ao executar ruby -v a versão 1.9.3-pxxx será exibida: 


ruby 1.9.3p194 (2012-04-20 revision 35410) [x86 64-darwin12.2.0] 
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É importante ressaltar que por default a versão do Ruby em sua máquina é a 
versão instalada diretamente no sistema operacional. Se você quiser que a versão 
default do sistema seja uma versão fornecida pelo RVM, basta executar: 


rvm --default 1.9.3 


Ao executar ruby -v a versão 1.9.3 será exibida como versão default da sua 
máquina. 

No próximo capítulo veremos algumas novidades que estão presentes na versão 
2.0 do Ruby. Então, já vamos nos preparar e instalar o Ruby 2.0: 


rvm install ruby-2.0.0-p0 


Para utilizar a versão recém-instalada basta executar: 


rvm use ruby-2.0.0-p0 


Pronto! Agora estamos utilizando a versão 2 . 0 .0-p0. Sempre que quiser voltar 
a utilizar alguma versão específica do projeto basta utilizar o comando rvm use 
xruby version aquix. 

Para instalar outros interpretadores Ruby, basta seguir os mesmos passos des- 
critos anteriormente. As versões suportadas pelo RVM podem ser vistas em: https: 
//rvm.io/interpreters/ 


11.3 ORGANIZE SUAS GEMS UTILIZANDO GEMSETS 


O RVM cria compartimentos independentes para cada versao do Ruby instalada, ou 
seja, o interpretador Ruby, as gems e o IRB são todos separados do sistema e uns 
dos outros. O que pode acontecer é que dois projetos que utilizam a mesma versão 
do Ruby precisem de versões diferentes de uma determinada gem. Como as gems 
são separados apenas por instalações do Ruby, o espaço de gems teria duas versões 
da mesma gem, o que poderia causar conflitos em sua utilização e a obrigação de 
utilizar o comando bundle exec para executar o projeto com as versões corretas de 
cada gem. 

O RVM permite que dentro do espaço de gems de cada instalação do Ruby, sejam 
criados espaços separados para as gems de cada projeto, evitando conflitos de ver- 
sões e mantendo seu sistema mais organizado. Estes espaços são conhecidos como 
gemsets (conjunto de gems). E também possui integração com o comando bundle 
install que instalará as gems diretamente no gemset configurado. 
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Crie gemsets 


Para criar um novo gemset basta executar: 


rvm gemset create loja virtual 
# => 'loja virtual! gemset created 
(/home/lucas/.rvm/gems/ruby-1.9.3-p1i9401oja virtual). 


Para utilizar o gemset criado basta executar: 


rvm use 1.9.30loja virtual 
# => Using /Users/lucas/.rvm/gems/ruby-1.9.3-p194 
with gemset loja_virtual 


Na raiz do projeto, vamos rodar o comando bundle install e após a sua 
execução podemos verificar as gems instaladas no gemset executando o comando 


que já vimos anteriormente gem list: 


*++ LOCAL GEMS *** 


active file (0.0.5) 
brnumeros (3.3.0) 


Para comprovar que as gems estão isoladas no gemset, vamos criar um outro 
novo einstalaro rails nela: 


rvm gemset create novo gemset 
rvm use 1.9.30novo gemset 
gem install rails 


Executando o comando gem list serão listadas apenas o rails e suas de- 
pendências: 


*++ LOCAL GEMS *** 


actionmailer (3.2.11) 
actionpack (3.2.11) 
activemodel (3.2.11) 
activerecord (3.2.11) 
activeresource (3.2.11) 
activesupport (3.2.11) 
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As gems existentes no gemset loja virtual não são listadas, pois estão isoladas. 





REMOVENDO GEMS DO SISTEMA 


O RVM possui um gemset chamado global onde as gems instaladas 
antes da utilização do RVM estão: 


rvm use 1.9.30global 
# => Using /Users/lucas/.rvm/gems/ruby-1.9.3-p194 
with gemset global 


gem list 
*** LOCAL GEMS *** 


bundler (1.2.3) 

rake (10.0.3, 10.0.2) 
rubygems-bundler (1.1.0) 
rvm (1.11.3.5) 


Ja que estamos organizando as gems em gemsets, devemos remover 
as gems globais. Basta executar o comando rvm gemset empty que 
limpará o gemset que você estiver utilizando. 

O gemset global é bastante útil para adicionar automaticamente gems 
que serão utilizadas por todas as novas instalações ou novos gemsets cri- 
ados. As gems rake e bundler são bons exemplos de dependências 
que estarão presentes na grande maioria gemsets criados. 











11.4 TROQUE AUTOMATICAMENTE DE GEMSETS COM 
-RVMRC 


Ao utilizar mais de um gemset, é necessário lembrar de trocá-lo de acordo com o pro- 
jeto que estamos trabalhando. Como programadores, é ruim termos que lembrar de 
executar o comando rvm use 1.9.3@meu_gemset a todo momento. Em geral, 
preferimos que estas coisas sejam feitas de maneira automática. 

O arquivo . rvmrc permite que estas trocas sejam feitas de maneira automática. 
Ao adicionar um arquivo chamado .rvmrc dentro do projeto, toda vez que entrar- 
mos na pasta do projeto, o RVM irá procurar por esse arquivo e executar o comando 
que se encontra dentro dele. 
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O arquivo .rvmrc terá, geralmente, a linha corresponde a troca para o gemset 
do projeto. Por exemplo, o arquivo .rvmrc do projeto loja virtual terá o seguinte 
conteúdo: 


rvm use 1.9.30loja virtual 


Porém, o código acima ao ser executado pela primeira vez, nos alertará que não 
podemos utilizar um gemset que não foi criado: 


Gemset 'loja virtual! does not exist, 'rvm gemset create loja virtual! 


first, or append '--create'. 


Como foi alertado pelo RVM, podemos apenas adicionar o --create dentro 


do .rvmrc: 


rvm use 1.9.30loja virtual --create 





CRIANDO GEMSET E RVMRC EM UMA LINHA 


É possível criar um novo gemset e seu respectivo .rvmrc execu- 
tando a seguinte linha: 


rvm --create --rvmrc 1.9.30seu gemset 











11.5 PRÓXIMOS PASSOS 


O objetivo deste capítulo foi descrever como funcionam as principais funcionalida- 
des do RVM. Você pode consultar a documentação do RVM no site: https://rvm.io 
onde são listadas todas as suas funcionalidades. 

No próximo capítulo veremos as novas features que estarão disponíveis na nova 
versão da linguagem Ruby. Faremos alguns testes e exploraremos seus novos con- 
ceitos, que tornarão a vida dos desenvolvedores Ruby um pouco mais fácil do que já 


r 


e. 
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CAPITULO 12 


Ruby 2.0 


A versão final foi lançada no dia 24 de fevereiro, exatamente no vigésimo aniversário 
de sua primeira versão. A ideia deste capítulo é falar sobre as principais mudanças 
que ocorrerão na linguagem que você aprendeu durante os capítulos anteriores. 

Uma lista completa com as mudanças introduzidas na versão 2.0 podem ser vis- 
tas aqui: https://github.com/ruby/ruby/blob/v2 o o rci/NEWS, enquanto que aqui 
nos ateremos às principais: 


* Refinements 


e Named Parameters 


Module prepend 
e Enumerable Lazy 


* Encoding UTF-8 
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12.1 EVITANDO MONKEY PATCHES COM REFINEMENTS 


Você aprendeu anteriormente que é possível abrirmos uma classe Ruby e adicionar 
novos métodos dinamicamente. Por exemplo, podemos abrir a classe String e 
adicionar um novo método chamado bang: 


class String 
def bang 
"#{self}!" 
end 
end 


Executando o código acima, faz com que todos os objetos do tipo String te- 
nham um método chamado bang: 


"ruby".bang # => "ruby!" 
"rails".bang # => "rails!" 


Ruby é uma linguagem onde todas as classes são mutáveis. Essa habilidade de 
alterar classes em runtime é utilizada em diversas bibliotecas. Um exemplo, é o 
ActiveSupport, uma pedaço do Rails que abre várias classes do core do Ruby, para 
adicionar métodos utilitários que visam facilitar o desenvolvimento. Essa técnica é 
conhecida na comunidade Ruby, como Monkey Patch. 

Porém, abrir uma classe e adicionar métodos arbitrários é uma técnica questi- 
onável. Apesar de parecer legal, pode nos trazer grandes transtornos. O problema 
principal desta abordagem é que assim como nós abrimos a classe String e adici- 
onamos um método chamado bang, qualquer outra biblioteca Ruby que utilizamos 
pode fazer exatamente a mesma coisa. O que aconteceria neste caso depende muito 
da ordem de carregamento, o que causaria também comportamentos inesperados na 
execução da aplicação. 

A mudança feita na classe St ring é globale trabalhar com escopos globais sem- 
pre é ruim, por ter de controlar cada lugar que pode, eventualmente, alterar aquele 
escopo. 

Pensando nestes problemas recorrentes oriundos das versões atuais do Ruby, foi 
pensado uma funcionalidade chamada refinements, que visa alterar o escopo de 
uma classe apenas em contexto local, ou seja, você escolhe o momento exato que 
deseja que a classe String tenha o método bang. Isso evita os possíveis problemas 
descritos anteriormente. 
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Vamos ver como essa nova feature da linguagem Ruby funciona. Existem dois 
métodos importantes que temos que conhecer quando decidimos utilizar os refine- 
ments, o primeiro é o método refine do módulo Kernel, que permite que o mon- 
key patch seja feito em um escopo local, na verdade, ele funciona como se fosse um 
container de métodos adicionais que podem ser utilizados em um futuro próximo 
dentro de um escopo que não seja global. 

O segundo é o método using, que permite que os refinements sejam utilizados 
em uma classe ou método, ou seja, permite que os métodos “adicionais” da classe 
String sejam injetados no escopo onde você invocá-lo, ou seja, os métodos serão 
adicionados apenas no escopo onde você efetuou a chamada, para todos os outros, 
o método bang simplesmente não existirá. 

Para implementar refinements, o primeiro passo é abrir a classe String e adi- 
cionar o método bang utilizando o método Kernel#refine: 


module StringBang 
refine String do 
def bang 
"#{self}!" 
end 
end 
end 


Agora, se tentarmos invocar o método bang em um objeto St ring, sera retor- 
nada uma exceção dizendo que o método não existe: 


"ruby" . bang 
# => NoMethodError: undefined method `bang' for "":String 


Isso aconteceu porque a classe String foi alterada em um escopo local. Para 
utilizar o refinement que foi feito, devemos utilizar o método using, no objeto main: 


using StringBang 
"ruby" .bang # => "ruby!" 


class DVD 
# outros metodos aqui 
def titulo 
@titulo.bang 
end 
end 
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dvd = DVD.new "Chitãozinho e Xororo" 
dvd.titulo & => "Chitãozinho e Xororo!" 


Essa é uma importante feature na versão 2.0 que evitará vários problemas que os 
monkey patches globais podem causar. A dica para você que utiliza monkey patches é 
evitá-los ao máximo. Uma boa alternativa é criar módulos que definem os métodos 
que você deseja incluir e utilizar o extend para incluí-los apenas nos objetos que 
você deseja: 


module Banger 
def bang 
"#{self}!" 
end 
end 


“ruby".extend(Banger).bang # => "ruby!" 


No código acima, nós também estamos adicionando o método desejado em um 
escopo não global. Porém, adicionamos apenas nos objetos do tipo String que 
desejamos. Apesar de ser bastante chato invocar extend (Bang) em vários lugares, 
é bem mais garantido que não teremos problemas futuros. 


12.2 NAMED PARAMETERS 


Lançado com o nome Keywords Arguments, esta nova feature da linguagem Ruby já 
existe em outras linguagens ha bastante tempo e foi finalmente introduzida na nova 
versao. 

Para vocé que nao conhece named parameters vamos entender o problema que 
este conceito resolve. Supondo que vocé tenha um método chamado setup que 
precisa receber algumas informações: timeout e name. Implementamos o método 
com o código abaixo: 


def setup(timeout, name) 
p timeout * 1000, name 
end 


Ao invocarmos 0 método setup, devemos passar os argumentos de acordo com 
a posição que eles foram declarados: 
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setup 60, 'correios' 


Se invocarmos o método trocando a posição dos parâmetros podemos ter sur- 
presas: 


setup 'correios', 60 
# => correioscorreioscorreios... 


A String correios será impressa 1000 vezes na saída do console. Ao utilizar- 
mos named parameters, invocamos o método passando não apenas os valores dos pa- 
râmetros, mas também, qual argumento receberá aquele valor. Faremos algo como 
o código abaixo: 


setup timeout: 60, name: 'correios' 
# => 60000, 'correios' 


Porém, para este código funcionar, devemos alterar a implementação do método 
para suportar named parameters: 


def setup(timeout: 0, name: '') 
p timeout, name 
end 


É necessário declarar um valor default para que os argumentos possam ser pre- 
enchidos corretamente na chamada do método utilizando named parameters. Essa 
nova implementação do método setup nos permite invocar o método das seguintes 


maneiras: 


# passando apenas o atributo timeout 
setup timeout: 20 
# => 20, '' 


# passando apenas o atributo name 
setup name: 'sedex' 
# => 0, 'sedex' 


# passando nenhum deles 
setup 
# =>0 pi 


# passando os atributos em ordem inversa 
setup name: 'sedex', timeout: 20 


# => 20, 'sedex' 
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O mais interessante é que não precisamos passar os argumentos na ordem cor- 
reta, basta chamar o método passando o valor de cada argumento através de seu 
nome. 

Vamos alterar um pouco o método setup adicionando um atributo que não 
terá a característica de um named parameter: 


def setup(value, timeout: 0, name: '') 
p value, timeout, name 
end 


Com essa mudança, todas as chamadas que foram feitas no exemplo anterior, 
não funcionarão, pois o atributo value, esta declarado como atributo obrigatório 
e deve ser sempre o primeiro atributo a ser passado na chamada do método. Sendo 
assim as chamadas anteriores devem ser transformadas: 


# passando apenas o atributo timeout 
setup 79.9, timeout: 20 
# => 79.9, 20, !! 


# passando apenas o atributo name 
setup 79.9, name: 'sedex' 
# => 79.9, O, 'sedex' 


# passando nenhum deles 
setup 79.9 
# => 79.9, 0, !! 


# passando os atributos em ordem inversa 
setup 79.9, name: 'sedex', timeout: 20 
# => 79.9, 20, 'sedex' 


# passando o parametro valor no final 
setup name: 'sedex', timeout: 20, 79.9 
# => SyntaxError: (irb):19: syntax error 


Isso deixa um pouco claro que os named parameters na verdade são apenas atri- 
butos com valores default. 


Vamos explorar um pouco mais os named parameters tentando declarar um novo 
atributo após o último named parameter: 
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def setup(value, timeout: 0, name: '', url) 
p value, timeout, name, url 
end 


# => SyntaxError: (irb):23: syntax error, unexpected tIDENTIFIER 


O interpretador Ruby não permite que tal declaração de método seja feita. É 
permitido apenas que um Hash seja declarado como atributo não nomeado no final 
da declaração de um método: 


def setup(value, timeout: O, name: » **options) 


p value, timeout, name, options 
end 


Com este últimos argumento, podemos invocar o método setup passando um 
Hash com os valores que quisermos: 


setup 79.9, name: 'sedex', timeout: 20, 
url: 'http://correios.cep.com.br/consulta' 


# => 79.9, 20, 'sedex', { :url => "http://correios.cep.com.br/consulta" } 


A dica então é sempre declarar os named parameters no final do método e os 
outros atributos no começo. 


12.3 UTILIZE PREPEND AO INVÉS DE INCLUDE 


Vamos relembrar rapidamente como funcionam os módulos em Ruby. Módulos, 
podem ser utilizados para a criação de namespaces ou como container de métodos 
que serão incluídos em classes, técnica conhecida como mixings. Por exemplo: 


module FormatadorMoeda 
def valor formatado 
Gvalor.por extenso em reais 
end 
end 


class DVD 
include FormatadorMoeda 


def initialize(valor) 
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@valor = valor 
end 
end 


dvd = DVD.new 56.6 
dvd.valor_formatado # => cinquenta e seis reais e sessenta centavos 


Como vimos anteriormente, ao dar include de um módulo dentro de uma 
classe, a mesma ‘ganha todos os métodos que foram declarados no módulo. Al- 
gum desenvolvedor mais desatento, pode recriar um método valor formatado 
na classe DVD com um comportamento completamente diferente do que fora defi- 


nido no módulo: 


class DVD 
include FormatadorMoeda 


def initialize(valor) 
@valor = valor 
end 


def valor_formatado 
"R$ #{@valor}" 
end 
end 


dvd = DVD.new 56.6 
dvd.valor_formatado # => R$ 56.6 


E o comportamento do método valor formatado definido no módulo 
FormatadorMoeda foi sobrescrito pela própria classe que o incluiu. O que aconte- 
ceu na verdade não foi uma sobrescrita de método, o que aconteceu é que o inter- 
pretador Ruby sempre irá procurar pelo método respeitando o object model, ou 
seja, primeiro irá buscar o método na própria classe DVD e como encontrará uma im- 
plementação do método valor formatado disponível, irá executá-lo e não será 
necessário procurá-lo dentro do módulo FormatadorMoeda. 

Podemos ordenar que o interpretador Ruby procure pelo método 
valor formatado primeiro nos módulos e depois na própria classe DVD, 
basta utilizarmos o método prepend e não mais o método include: 


class DVD 
prepend FormatadorMoeda 
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def initialize(valor) 
@valor = valor 
end 


def valor_formatado 
"R$ #{@valor}" 
end 
end 


dvd = DVD.new 56.6 
dvd.valor_formatado # => cinquenta e seis reais e sessenta centavos 


Repare que o método valor formatado foi procurado primeiramente no 
FormatadorMoeda e como o mesmo foi encontrado, não foi necessário buscá-lo 
na classe DVD. 


12.4 UTILIZANDO LAZY LOAD NO MÓDULO ENUMERABLE 


Ruby é uma linguagem imperativa, porém, permite que sejam feitos códigos elegan- 
tes que possuem características funcionais. Por exemplo: 


[1, 2, 3, 4, 2, 5].map { |numero| numero * 10 } 
# [10, 20, 30, 40, 20, 50] 


Criamos um novo Array a partir do primeiro Array com todos os numeros 
multiplicados por 10. Agora, precisamos que deste novo Array sejam extraidos 
apenas os numeros maiores que 30. Simples: 


[1, 2, 3, 4, 2, 5].map { |numero| numero * 10 + 
.select { |numero| numero > 30 + 
# [40, 50] 


Porém, o código acima apesar de ser bastante elegante e legível, possui um pro- 
blema de performance. São criados Arrays intermediários a cada manipulação 
que é feita, neste caso, dois Arrays desnecessários. Na verdade, ao manipular um 
Array pequeno como o do exemplo, isso pode não parecer um problema, mas se 
estivéssemos parseando um arquivo de 1GB teríamos sérios problemas. 

A versão 2.0 do Ruby copiou, no bom sentido, uma característica presente na 
maioria das linguagens funcionais existentes, as lazy collections. Isso significa que 
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podemos evitar a criação destes Arrays intermediários e executar o processamento 
das funções utilizadas para manipular a coleção uma única vez. 

Na prática basta invocarmos o método lazy antes de encadear as chamadas 
funcionais nos dados que desejamos manipular: 


[1, 2, 3, 4, 2, 5].lazy.map { |numero| numero * 10 } 
.select { |numero| numero > 30 + 
# <Enumerator: :Lazy: 
# <Enumerator: :Lazy: 
#<Enumerator::Lazy: [1, 2, 3, 4, 2, 5]>:map>:select> 


Repare que o retorno não foram os números 40 e 50 como anteriormente. Ao 





invés disso, foi retornado um objeto Enumerator::Lazy, ou seja, nenhum pro- 
cessamento foi feito no código anterior. Para que as funções map e select sejam 
executadas no Array original, basta invocar o método to a: 


lazy array = [1, 2, 3, 4, 2, 5].lazy 
.map { |numero| numero * 10 } 
.select { |numero| numero > 30 + 


p lazy array.to a 
# [40, 50] 


12.5 ENCODING UTF-8 


Na versão 1.9 do Ruby, o encoding default é US-ASCII. Na prática isso significa 
que se você quiser utilizar caracteres acentuados, sera necessário a utilização de um 
comentário no começo do arquivo: # coding: utf-8 ou umaexceção invalid 
multibyte char (US-ASCII) será lançada. 

No versão 2.0 o encoding default é UTF-8. Com isso ao escrever caracteres com 
acento, não é mais necessário a utilização do comentário que altera o encoding. Você 
pode querer manter a compatibilidade entre as versões 1.9 e 2.0, neste caso, manter 
o comentário é necessário. 


12.6 PRÓXIMOS PASSOS 


Neste capítulos vimos as principais novidades que estão disponíveis na versão 2.0 
da linguagem Ruby. No próximo, veremos um dos assuntos mais polêmicos sobre a 
linguagem: concorrência e paralelismo. Veremos se isso existe de verdade em Ruby 
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e quais as vantagens e desvantagens de cada uma das abordagens disponíveis atual- 
mente. 
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CAPÍTULO 13 


Apêndice: Concorrência e 
paralelismo 


Concorrência é a capacidade de compor um cenário onde as tarefas podem ser exe- 
cutadas independentes uma das outras. Paralelismo é a capacidade de executar várias 
destas tarefas simultaneamente. 

Complicado não é mesmo? Vou tentar algo ‘do mundo real’ para exemplificar a 
diferença entre estes dois conceitos computacionais. 

Vamos supor que você precisa fazer exercícios de matemática e história que fo- 
ram atribuídos como homework. Você decide resolver um exercício de matemática e 
depois um exercício de história, depois você faz outro exercício de matemática e após 
um outro exercício de história, até que todos os problemas estejam resolvidos. Ao 
trazermos a metáfora para o mundo da computação, estamos fazendo os exercícios 
de forma concorrente. 

Se concorrência significa fazer várias tarefas simultaneamente uma de cada vez, 
o que é paralelismo? Paralelismo é a habilidade de executar um pouco de cada tarefa, 
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de maneira simultânea. Por exemplo, dirigir seu veículo e fazer um audio curso de 
inglês ao mesmo tempo. Você pode progredir nas duas tarefas de maneira simulta- 
nea. 

Trazendo de volta para o mundo da computação, mais especificamente para o 
mundo web, suponha que você tem uma aplicação Rails que possui um grande trá- 
fego de usuários, algo em torno de 1 request por segundo. Ao executar um bench- 
mark nesta aplicação você percebe que a mesma tem uma média de tempo de res- 
posta em torno de 100ms por request, o que nos leva a crer que a aplicação suporta 
10 requests por segundo, aproximadamente. 

Se a aplicação alcançar um número maior que 10 requests por segundo, eles se- 
rao enfileirados e startados apenas quando o servidor estiver livre, causando um au- 
mento no tempo final do request. Esse é um dos motivos pelos quais devemos nos 
preocupar com concorrência e paralelismo. Independente da linguagem que esta- 
mos falando, existem diversas maneiras de resolver este problema. Cada uma das 
soluções causa muita discussão, pois, muitas pessoas defendem seus pontos de vista, 
tanto os bons quanto os ruins. Frases como: ‘Ruby não escala” são muito comuns, 
porém, é um sinal de que o desenvolvedor não entende corretamente o que é ne- 
cessário para escalar um programa feito em determinada linguagem, seja ela qual 
for. 

Os mais sensatos defenderão suas abordagens para escalar o sistema, alguns de- 
fendem a utilização de Threads, mas talvez se esquecem das dificuldades de lidar com 
memória compartilhada, outros dizem que você deve trocar a linguagem e utilizar 
Node.js, por exemplo. Existem os que defendem a programação orientada (event 
based) dentro da própria linguagem hospedeira. 

O importante é entender os benefícios e malefícios que cada uma das aborda- 
gens podem trazer para sua equipe e para a sua empresa, e escolher a que melhor se 
encaixa no problema. Entender que a escolha da linguagem muda a decisão que será 
tomada para melhorar a performance de uma aplicação também é importante, pois 
cada uma delas possui abordagens mais adequadas para resolver o mesmo problema, 
cada uma com suas características. 

A ideia deste capítulo não é ensinar você a escalar uma aplicação, pois isso seria 
demanda de apenas um livro, mas sim mostrar os caminhos, vantagens e desvan- 
tagens das soluções existentes para você melhorar a performance da sua aplicação 
Ruby, na maioria das vezes Rails também. Proponho um ‘ala boca’ as pessoas que 
criticam a linguagem Ruby sem realmente saber o que podem fazer para lidar com 
seus problemas. 
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13.1 THREADS 


Antes da versão 1.9 do Ruby, as Threads não eram nativas do Sistema Operacional, 
ou seja, elas eram gerenciadas pelas Virtual Machine, o que causava grandes proble- 
mas, já que elas não se aproveitavam de várias vantagens disponibilizadas automa- 
ticamente pelo S.O (leia mais sobre as green threads: http://en.wikipedia.org/wiki/ 
Green threads). A partir da versão 1.9, as Threads são nativas do Sistema Ope- 
racional, o que pode levar você a pensar que os desenvolvedores Ruby poderiam 
implementar Threads assim como os desenvolvedores Java fizeram por muitos anos. 

Porém, isso não é bem a verdade. A linguagem Ruby possui um mecanismo 
de lock chamado Global Interpreter Lock carinhosamente conhecido como GIL. Este 
mecanismo evita que várias Threads possam alterar um dado compartilhado entre 
elas, com isso é praticamente impossível alcançar concorrência em aplicações Ruby. 
Outro agravante é que muitas bibliotecas Ruby são escritas na linguagem C, e estas 
bibliotecas não são Thread Safe com isso seria muito perigoso utilizar estas biblioteca 
em um ambiente multi thread sem utilizar o GIL. 

Isso que dizer que nunca poderei utilizar Threads enquanto utilizar Ruby? Não, 
mentira. Você pode utilizar Threads desde que utilize algum interpretador que não 
possua um Global Interpreter Lock, como o JRuby. Mas lembre-se, principalmente se 
você veio do mundo Java, você pode utilizar Threads utilizando JRuby, mas enfren- 
tará os mesmos problemas enfrentados quando desenvolvia em Java: garantir que 
seu código é thread safe, checar que todas as bibliotecas que você utiliza são thread 
safe também, não fazer deadlocks e vários outras dificuldades encontradas quando 
manipulamos Threads manualmente. 


13.2 MÚLTIPLOS PROCESSOS 


Este é de longe o mecanismos mais utilizado no mundo Ruby para escalar princi- 
palmente aplicações feitas em Rails. Pelo simples motivo de ser difícil trabalhar com 
Threads, os desenvolvedores Ruby na maioria das vezes preferem apenas startar mais 
processos. O problema neste caso é que você precisa se preocupar em sincronizar os 
dados que transitam entre os processos, será necessário alguma ferramenta, como 
por exemplo o DRb (http://segmentz.net/projects/ruby/drb) que permite a comuni- 
cação entre diferentes processos Ruby. 

Existe ainda um problema em relação a memória física que será utilizada. Por 
exemplo, se um processo Ruby gastar 200MB de memória, e você forkar mais 4 pro- 
cessos idênticos a este, o espaço em memória para cada um será de 200MB, o que 
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gera uma demanda de pelo menos 1GB de memória física. Servidores web como o 
Mongrel, funcionam desta maneira, por isso não devem ser utilizados em produção. 

Serviços mais robustos como Passenger (módulo para Apache o Ngix) e o Uni- 
corn implementaram uma solução um pouco mais elegante e eficiente. Eles forkam o 
processo através do Sistema Operacional Unix que cria uma cópia do processo origi- 
nal e faz com que eles compartilhem a mesma memória física. A sacada é que quando 
um processo altera algum dado na memória os outros processos não são afetados. 
Desta maneira é possível termos cinco processos rodando gastando apenas 200MB 
de memória física e atendendo cinco vezes mais requisições concorrentemente. 

A parte interessante é que podemos parar apenas um processo por vez, isso é 
bom quando desejamos, por exemplo, fazer deploy de uma aplicação sem que haja 
downtime para os usuários. 


13.3 FIBERS 


A partir do Ruby 1.9, é possível criar código que são executados de forma concor- 
rente, utilizando as Fibers, recurso muito parecido com as threads, porém, mais sim- 
ples e leves. A diferença é que uma Fiber não é gerenciada pela máquina virtual ou 
pelo sistema operacional, mas sim pelo próprio desenvolvedor. 

Outra diferença importante, é que fibers são mais rápidas de serem criadas e não 
ocupam muito espaço em memória, pois rodam sempre dentro de uma única thread. 
Justamente por rodar em apenas uma única thread é que não se pode confiar que 
dados compartilhados serão alterados entre diversas fibers, por isso a importância 
do Global Interpreter Lock para garantir a integridade dos dados neste cenário. 

A pergunta que nos fazemos é: 'Se fibers rodam dentro de uma única thread, 
onde está o grande benefício da concorrência ? 

A resposta é que fibers são partes de uma solução mais robusta. Elas permitem, 
por exemplo, que os desenvolvedores gerenciem manualmente o fluxo de concor- 
rência que executará as tarefas necessárias. Por exemplo, suponha que seu servidor 
web receba um request e que existe um tempo, mesmo que mínimo, para que a res- 
posta seja gerada ao usuário. Neste meio tempo, outros requests podem chegar e não 
é interessante que estes esperem que o primeiro request seja concluída para serem 
atendidos. 

Ao utilizar uma fiber por request, garantimos que ao receber uma requisição o 
servidor a deixe sob os cuidados de sua própria fiber, enquanto isso outras requisi- 
ções são atendidas e repassadas para suas próprias fibers. Conforme cada fiber for 
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concluída o seu resultado será retornando para o usuário. 

O único problema desta abordagem é quando existe a necessidade de utilizar 
I/O blocante, por exemplo, acessar um banco de dados, enviar email, etc. Como 
existe uma única thread, qualquer fiber que precise utilizar I/O, irá bloqueá-la e assim 
perderemos os benefícios da utilização de fibers. 


13.4 O DESIGN PATTERN REACTOR 


O design pattern reactor é bem simples, ele consiste em delegar chamadas IO para 
serviços externos (reactors) que suportam requisições concorrentes. Estes reactors 
proveem uma maneira de registramos callbacks que serão disparados assincrona- 
mente, assim que as requisições forem completadas. 

Suponha que sua aplicação web precisa consultar um web service externo para re- 
tornar informações ao usuário. Essa requisição pode ser bastante lenta, dependendo 
da performance de uma aplicativo de terceiros. Utilizando reactor, nós apenas rece- 
bemos a requisição e delegamos a chamada ao web service externo para um handler, 
e dizemos para este o que deverá ser feito quando a requisição externa terminar, 
ou seja, registramos callbacks que serão executados baseados na resposta do recurso 
externo em questão. 

No caso da sua aplicação rodar em um servidor web single thread existe uma 
questão importante. Quando recebemos o request e delegamos a chamada ao web 
service para um handler continuamos bloqueando a thread e evitando o processa- 
mento de novas requisições. Para evitar que isso aconteça, o ideal é encapsular o 
request dentro de uma fiber, efetuar o request ao web service e pausar a fiber de modo 
que outras requisições possam ser processadas enquanto aguarda-se a chamada ao 
web service. Quando esta chamada for efetuada, a fiber é novamente ativada e final- 
mente a resposta é enviada ao cliente. 

Esta é a abordagem utilizada pelo EventMachine (Ruby) e pelo Node.js (Javas- 
cript). O Thin é um dos servidores web Ruby escritos baseando-se no EventMachine, 
existem também várias bibliotecas baseadas no EventMachine que podem ser utili- 
zadas de maneira standalone para fazer requisições assíncronas. 

O único problema de utilizar o padrão reactor é quebra de paradigma no mo- 
mento de escrever o código. Se você não tomar o cuidado necessário, pode aca- 
bar com uma grande quantidade de callbacks aninhados, problema também en- 
frentado quando utilizamos Node.js. Recomendo que você leia o artigo do Martyn 
Loughran, um dos criadores do Pusher: http://rubylearning.com/blog/2010/10/01/ 
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an-introduction-to-eventmachine-and-how-to-avoid-callback-spaghetti. Neste ar- 
tigo ele explica como evitar callbacks macarrônicos quando utilizamos Event Ma- 
chine. 


13.5 CONCLUSÃO 


A conclusão que particularmente chego é que concorrência em Ruby é algo possível 
e pode ser feito de muitas maneiras. Utilizando os fibers que surgiram no Ruby 1.9, 
que em conjunto com IO não bloqueante, permite que seja alcançado altos níveis de 
concorrência. Existe também a opção de forkar processos existentes, como é feito no 
passenger, que pode ser utilizado tanto com Nginx quanto com Apache. 

Lembrando que quando desenvolvemos aplicações web, questões como cache e 
minimizar dependências externas sempre devem ser levadas em consideração para 
melhorias na performance. Se você precisa escalar uma aplicação web que utiliza 
Ruby, tem a obrigação de estudar não apenas as técnicas descritas anteriormente, 
mas também estas questões. 
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